How echovic/boss-skill works
Boss is an auditable workflow skill for coding agents: it coordinates planning through delivery, records runtime evidence, and exposes results through a bundled CLI. The map emphasizes that user-to-result path plus quality checks and documented hooks, packs, memory, and preview capabilities. The sampled code directly supports CLI initialization/inspection, pipeline setup, event projection, and artifact-DAG handling; broader feature wiring is included only where described by the README or tree.
Main entry points: pipeline.ts Pipeline orchestration · boss.ts Bundled CLI · state.ts Event and state access · pipeline-dag.ts Artifact dependencies
Components 21
Agent workflow
- Bundled CLI
packages/boss-cli/src/bin/boss.ts - Command dispatch
packages/boss-cli/src/cli/dispatcher.ts - Project workflow
packages/boss-cli/src/commands/project/index.ts - Pipeline orchestration
packages/boss-cli/src/runtime/application/pipeline.ts - Plan, review, build, ship
packages/boss-cli/src/runtime/application/pipeline.ts
Runtime audit
- Event and state access
packages/boss-cli/src/runtime/application/state.ts - Append-only event log
- State projection
packages/boss-cli/src/runtime/projectors/materialize-state.ts - Execution view
- Runtime inspection
packages/boss-cli/src/runtime/application/inspection.ts
Quality and artifacts
- Artifact dependencies
packages/boss-cli/src/runtime/application/pipeline-dag.ts - Workflow artifacts
- Quality gates
packages/boss-cli/src/runtime/application/gates.ts - QA and verification
packages/boss-cli/src/runtime/application/qa-attack.ts - Reports and summaries
packages/boss-cli/src/runtime/report/render-markdown.ts
Hooks and extensions
- Agent lifecycle hooks
skill/scripts/hooks/session-start.js - Plugins and packs
packages/boss-cli/src/runtime/application/plugins.ts - Persistent agent memory
packages/boss-cli/src/runtime/application/memory.ts - Design preview
packages/boss-cli/src/runtime/design/server.ts
Other components
- Coding agent
- Project filesystem
Connections 25
- Coding agent → Bundled CLI: runs commands
- Bundled CLI → Command dispatch: dispatches
- Command dispatch → Project workflow: routes workflow
- Project workflow → Pipeline orchestration: initializes pipeline
- Pipeline orchestration → Plan, review, build, ship: coordinates stages
- Pipeline orchestration → Artifact dependencies: resolves dependencies
- Pipeline orchestration → Plugins and packs: registers plugins
- Pipeline orchestration → Event and state access: records lifecycle
- Event and state access → Append-only event log: appends events
- State projection → Append-only event log: replays events
- State projection → Execution view: materializes view
- Event and state access → Execution view: reads view
- Artifact dependencies → Execution view: reads pipeline config
- Artifact dependencies → Project filesystem: loads DAG
- Plan, review, build, ship → Workflow artifacts: produces artifacts
- Quality gates → Append-only event log: records verdicts
- QA and verification → Quality gates: runs checks
- Runtime inspection → Event and state access: reads runtime
- Runtime inspection → Execution view: summarizes state
- Bundled CLI → Runtime inspection: invokes inspection
- Reports and summaries → Workflow artifacts: renders evidence
- Agent lifecycle hooks → Bundled CLI: invokes runtime
- Persistent agent memory → Project filesystem: stores memory
- Plugins and packs → Project filesystem: loads extensions
- Design preview → Coding agent: serves preview