echoVic/boss-skill

What it solves

Boss transforms a single coding agent into a structured, auditable engineering team. It solves the problem of "prompt-only" orchestration, where there is no verifiable proof that a plan was followed, tests were run, or quality gates were passed, often leading to hallucinations or skipped steps in complex software development.

How it works

Boss implements an event-sourced runtime that tracks the state of a project in a .boss/ directory. It organizes work into a four-stage pipeline (Requirement Clarification $\rightarrow$ Planning $\rightarrow$ Implementation/QA $\rightarrow$ Deployment) and assigns specific roles—such as PM, Architect, Tech Lead, and QA—to the agent.

Key technical mechanisms include:

• Event Sourcing: Pipeline state is appended to a JSONL event stream, making the process replayable and transparent.
• Runtime Gates: Non-bypassable quality checks (e.g., linting, test evidence, and API latency targets) that must be passed before moving to the next stage.
• Artifact Generation: The system automatically produces tangible evidence like PRDs, architecture docs, and QA reports.
• Agent Integration: It installs as a "skill" into existing coding agents like Claude Code, Codex, and Hermes.

Who it’s for

It is designed for developers and teams working on medium-sized product features, API services, or full-stack applications where a traceable audit trail and repeatable quality gates are more important than quick, one-line fixes.

Highlights

• Multi-Role Simulation: Simulates a full team (PM, Architect, UI Designer, Tech Lead, Scrum Master, Frontend, Backend, QA, and DevOps).
• Auditable Workflow: Uses an event-sourced runtime to prevent state hallucination and ensure process compliance.
• Deterministic Evals: Allows scoring of captured transcripts without needing to call an LLM.
• Flexible Execution: Supports running the full pipeline or triggering individual roles (e.g., /boss:review for a Tech Lead review).
• Cross-Platform CLI: Provides a robust CLI for inspecting pipeline status and managing runtime state across Linux, macOS, and Windows.