--- name: core description: Core utilities for FABER workflow management - config loading, state management, status cards model: claude-opus-4-5 --- # FABER Core Skill Provides core utilities for FABER workflows including configuration management, state tracking, and status card generation. ## Purpose This skill contains the fundamental operations needed by all FABER workflows: - Load and parse configuration - Manage workflow state (read, update, write) - Generate and post status cards to work tracking systems - Handle template variable substitution ## Operations ### Load Configuration Loads and parses the FABER configuration file. ```bash .\/scripts\/config-loader.sh [config_path] ``` **Parameters:** - `config_path` (optional): Path to config file (defaults to `.faber.config.toml`) **Returns:** JSON representation of configuration **Example:** ```bash config_json=$(.\/scripts\/config-loader.sh) work_system=$(echo "$config_json" | jq -r '.project.issue_system') ``` ### Read State Reads the current FABER workflow state. ```bash .\/scripts\/state-read.sh ``` **Parameters:** - `state_file`: Path to state file (`.fractary\/plugins\/faber\/state.json`) **Returns:** State JSON with workflow progress **Example:** ```bash state_json=$(.\/scripts\/state-read.sh ".fractary\/plugins\/faber\/state.json") ``` ### Update Phase State Updates a specific phase in the FABER workflow state. ```bash .\/scripts\/state-update-phase.sh [data_json] ``` **Parameters:** - `phase`: FABER phase (frame, architect, build, evaluate, release) - `status`: Phase status (pending, in_progress, completed, failed) - `data_json` (optional): Additional phase-specific data as JSON **Returns:** Updated state JSON **Example:** ```bash .\/scripts\/state-update-phase.sh frame completed '{"work_type": "feature"}' ``` ### Write State Writes the complete FABER workflow state. ```bash .\/scripts\/state-write.sh ``` **Parameters:** - `state_file`: Path to state file (`.fractary\/plugins\/faber\/state.json`) - Input: State JSON via stdin **Returns:** Success\/failure status **Example:** ```bash echo "$STATE_JSON" | .\/scripts\/state-write.sh ".fractary\/plugins\/faber\/state.json" ``` ### Post Status Card Posts a formatted status card to the work tracking system. ```bash .\/scripts\/status-card-post.sh ``` **Parameters:** - `work_id`: Work identifier - `issue_id`: External issue ID - `stage`: Current FABER stage - `message`: Status message - `options_json`: Available options as JSON array (e.g., `["ship to staging", "hold", "reject"]`) **Returns:** Success\/failure indicator **Example:** ```bash .\/scripts\/status-card-post.sh abc12345 123 evaluate "Build is green" '["ship", "hold", "reject"]' ``` ### Pattern Substitution Replaces template variables in strings. ```bash .\/scripts\/pattern-substitute.sh