SpecsCLI
CLI Specs
CLI Specs
| Spec | Summary | Status |
|---|---|---|
| [[codex-typescript-mcp/SPEC]] | Baseline-delivered native TS7 semantic reads for Codex: pinned Typegraph runtime, tsconfig discovery, load-probe gate, HI-owned always-approved Codex entries, three-fact health in hi check. Architecture: [[codex-typescript-mcp/ARCHITECTURE]]. Implemented in PR #243 (CLI 6.1.0): [[codex-typescript-mcp/IMPLEMENTATION-NOTES]]. | Implemented |
| [[registry-baseline/SPEC]] | Registry-based Baseline distribution: public registry, two-file consumer state, three-way Drift Check, Harness adapters, one-run migration, issue #232 fix. Architecture: [[registry-baseline/ARCHITECTURE]]. | Compiled |
| [[issue-217-ci-efficiency/SPEC]] | Remove CI/test execution waste and irrelevant cache invalidation on 2-vCPU workers without sharding or a percentage target. | Compiled |
| [[issue-205-effect-backend-internal-modules/SPEC]] | Restore concrete Effect internal-module topology and repository boundaries while preserving service-authority ownership. | Implemented |
| [[issue-204-portable-commit-gates/SPEC]] | Resolve commit-gate owners from the active Git worktree and retain actionable process-launch diagnostics. | Compiled |
| [[issue-203-scaffold-convergence/SPEC]] | Preserve repository-owned wiki artifacts and make scaffold, lint generation, update, and repeated checks converge. | Compiled |
| [[issue-207-verification-recovery-skills/SPEC]] | Distribute the verification creator and updater with the planning pack while preserving project-owned verifier references. | Compiled |
| [[delivery-phase-flow-optimization/SPEC]] | Compose Project Verifier, dependency-granular implementation, compact delivery continuity, single-epoch review, bounded recovery, and measured optimization admission. | Implemented |
| [[agent-workflow-architecture-rules-autonomy/SPEC]] | Close applicable technical design during grilling, progressively disclose project-owned rules, and run Full Delivery without ordinary confirmation stops. | Compiled |
| [[project-verification-capability/SPEC]] | Add one project-owned app reference per runnable surface beneath verify-behavior; let implement-spec create Uncovered Surfaces and repair Uncovered Behavior while docs ingest leaves Feature Maps unchanged. | Implemented |
| [[IP-96-monorepo-foundation/SPEC]] | Establish the Harness Intelligence product monorepo while preserving existing CLI behavior and Turborepo validation. | Implemented |
| [[IP-97-effect-api-contract-boundary/SPEC]] | Define the shared Effect HttpApi contract boundary between CLI and backend control-plane implementation. | Implemented |
| [[IP-98-shared-scaffold-model/SPEC]] | Extract only the stable scaffold model primitives shared by CLI and API. | Implemented |
| [[IP-99-private-harness-wiki-app/SPEC]] | Make apps/wiki the private Fumadocs app and canonical source-content owner while preserving CLI wiki knowledge. | Implemented |
| [[IP-100-harness-methodology-domain/SPEC]] | Establish the harness methodology domain with readable IA, concept inventory, and lifecycle flows. | Implemented |
| [[IP-104-harness-lifecycle/SPEC]] | Codify the Harness lifecycle from requirements through backlog, specs, plans, implementation, review, debug, docs, and tracker closeout. | Implemented |
| [[IP-105-runtime-telemetry/SPEC]] | Establish project-level product telemetry for happy-path CLI value events without turning OTel or developer identity into adoption KPIs. | Implemented |
| [[IP-106-cli-harness-reporting/SPEC]] | Add CLI-backed harness friction reporting with API persistence, GitHub-linked follow-up shape, and report telemetry. | Implemented |
| [[IP-107-colleague-trust-gate/SPEC]] | Create the private colleague trust gate bundle with onboarding, validation story, failure model, checklist, walkthrough, and support loop. | Implemented |
| [[IP-138-backoffice-project-usage/SPEC]] | Build the internal backoffice for project usage adoption, repository mapping, operator identity, and GitHub-linked report triage. | Implemented |
| [[IP-157-curated-opensrc-example-repositories/SPEC]] | Define curated example repository context for framework packs and selected-pack prompt guidance. | Implemented |
| [[IP-170-clawpatch-bug-lifecycle/SPEC]] | Define ClawPatch-backed AFK bug discovery and selected finding resolution through global phase wrappers. | Implemented |
| [[IP-273-design-phase-asset-evidence/SPEC]] | Define design-phase routing, repo settings, durable visual assets, backlog evidence, and PR before/after handoff. | Reviewed |
| [[finder-phase-wayfinder-skill-workflow/SPEC]] | Define the shared finder-phase, lean wayfinder, and backlog-kind workflow for foggy work above requirements and delivery. | Reviewed |
| [[issue-178-180-finder-provider-intent-control/SPEC]] | Historical Finder control-envelope requirements superseded by the simpler Finder intake and Requirements Phase boundary. | Superseded |
| [[issue-180-finder-intake-requirements-boundary/SPEC]] | Keep Business and Functional Finder nontechnical, reserve Story and Task projection for Requirements Phase, and standardize the Linear Free hierarchy. | Compiled |
| [[project-backlog-operating-model/SPEC]] | Historical staged Finder operating model superseded by the Finder intake and Requirements Phase boundary. | Superseded |
| [[pre-existing-skills-scaffold-policy/SPEC]] | Align scaffold and update post-command skill reconciliation guidance around agent-owned exact-name overlap handling. | Implemented |
| [[cli-tool-validation/SPEC]] | Add explicit CLI validation for required external tools, short version output, and non-redundant agent-browser browser checks. | Implemented |
| [[issue-44-app-surfaced-wiki-root/SPEC]] | Ensure scaffold init/update handles app-surfaced single-repo wiki roots such as app/wiki before durable docs are authored. | Implemented |
| [[issue-67-backend-domain-structure/SPEC]] | Enhance the shared backend domain structure skill with generic architecture guardrails for layers, dependency direction, DI, public boundaries, and validation prompts. | Implemented |
| [[issue-68-effect-oxlint-rule-typing/SPEC]] | Ensure generated Effect package/app Oxlint configs typecheck while preserving nearest nested config placement. | Reviewed |
| [[cli-update-enforcement/SPEC]] | Enforce CLI and scaffold baseline drift checks with project-local version pins, dp check, session-start guidance, and subagent-owned remediation. | Implemented |
| [[settings-reconfiguration/SPEC]] | Reconfigure provider authorities and the backlog project destination without rerunning scaffold initialization. | Implemented |
| [[cache-release-diff-classification/SPEC]] | Share replay-safe local and CI verification, classify semantic baseline/npm impact, and publish eligible stable releases automatically from exact candidate evidence. | Compiled |
| [[cli-release-test-caching/SPEC]] | Reuse deterministic CLI verification across local development, pull-request CI, and protected releases without caching external mutations. | Compiled |
| [[ci-verification-and-publication/SPEC]] | Reduce verification to affected high-signal pull-request evidence and publish exact verified trees without replaying tests. | Compiled |
| [[scaffold-managed-format-hook/SPEC]] | Prevent the distributed automatic format hook from mutating any manifest-managed scaffold path. | Compiled |
| [[scoped-agent-guidance-authoring-contract/SPEC]] | Make generated docs and workspace prompts structure-first coding standards with exact progressive disclosure, scoped skill activation, and Source Guide routing. | Implemented |
| [[scaffold-skill-operator-followups/SPEC]] | Compact scoped prompt authoring, repair managed skill guidance, and remove stale operator target prompts on recognized hosts. | Compiled |
| [[review-phase-graph-rework/SPEC]] | Define explicit readonly review, immutable all-lens evidence, target adapters, and a bounded delivery review budget. | Implemented |
| [[implement-spec-execution-policy/SPEC]] | Release safe dependent work continuously, use compact context pointers, create an early draft PR, and bound post-implementation Code Review. | Implemented |
| [[review-contract-handoff-consistency/SPEC]] | Bind retained review evidence to committed bytes, derive deterministic routes, and align durable handoff and skill activation contracts. | Compiled |
| [[IP-317-compile-context-once-and-project-it-truthfully/SPEC]] | Compile repository context once as neutral semantic intent and project it through truthful versioned harness capability contracts. | Draft |
| [[IP-318-govern-project-settings-and-scaffold-state-safely/SPEC]] | Enforce project-setting authority, one deterministic desired state, and non-destructive managed-state reconciliation. | Draft |
| [[IP-319-establish-one-comprehensive-behavior-contract/SPEC]] | Classify every public outcome and protect it with one comprehensive high-signal repository behavior contract. | Reviewed |
| [[IP-320-domain-first-effect-v4-architecture/SPEC]] | Coordinate all Effect-dependent product surfaces around one exact v4 generation, deliberate domain boundaries, typed failures, focused configuration, and consumer-owned protocol runtime. | Draft |
| [[IP-321-hi-native-cli-presentation-contract/SPEC]] | Present every CLI operation through one structured semantic result, authoritative command metadata, and one HI-native renderer across interactive, plain, and JSON modes. | Draft |
| [[IP-322-operator-skill-state/SPEC]] | Resolve, expose, and verify immutable compatible operator-skill state across global and project-local scopes. | Draft |
| [[IP-323-verified-baseline-authority/SPEC]] | Resolve every baseline to one API-authoritative immutable identity that retrieval sources can only fetch and verify. | Draft |
| [[IP-324-v4-repository-cutover/SPEC]] | Complete the breadth-first v4-only repository migration and block merge or release until every packaged and consumer gate passes. | Draft |
| [[lefthook-commit-gate/SPEC]] | Provide default local Lefthook Commit Gate for eligible HI Catalogue consumers with durable policy and verified operational health. | Compiled |
| [[issue-197-scaffold-lifecycle/SPEC]] | Complete routine setup, preserve editable context, report truthful health and recover only affected scoped work. | Implemented |
- [[issue-200-201-219-220-validation/SPEC]]: Reliable candidate validation, affected update scope, and explicit commit coverage (compiled).
| [[issue-224-managed-lint/SPEC]] | Explicit software scopes and one preserved effective policy across managed lint entrypoints. | Compiled |