Skip to content

Specs Index

This folder is the stable “source of truth” for how enterprise-software-playbook is organized and evolved.

Use it to prevent taxonomy drift and to make multi-agent iteration converge.

How To Use These Specs

  • Before adding/renaming a skill, changing terminology, or changing the default workflow, update/add a spec (and usually a decision record).
  • Keep specs aligned with README.md and PROMPTS.md.

Documents

  • specs/skills-manifest.json: Machine-readable stage/tag index for retrieval and routing.
  • specs/tasks.md: Backlog of work with acceptance criteria.
  • specs/quickstart.md: Copy/paste commands to validate/package skills locally.
  • specs/009-archobs-agent-ergonomics.md: CLI ergonomics for agent workflows — cluster file inspection, full file-to-cluster JSON, auto-generated labels.
  • specs/010-archobs-velocity-edges-suggestions.md: Velocity queries, boundary edge inspection, and suggestion improvements for archobs.
  • specs/011-archobs-trajectory-feedback.md: Feedback-driven improvements — velocity compare, drift trend, monolith labels, trajectory fast path.
  • specs/012-skill-consolidation-and-cross-domain-integration.md: Merge trajectory→forecast and brief→intel; add cross-domain integration (archobs × forecast) to architecture, plan, design, and spec skills.
  • specs/013-topic-strategy.md: Topic strategy for the intelligence tool — SDLC decision framework, topic design principles, decision-relevant taxonomy (58 topics across 9 domains), classifier requirements, and topic lifecycle process.
  • specs/014-forecast-confidence-gates.md: Forecast confidence gates (amends spec 007) — lifecycle cold-start guard, chain confidence tiers, scenario score precision, and top-level data quality object. Co-ships with spec 015; shared v2 schema version bump.
  • specs/015-collection-quality-controls.md: Collection quality controls (amends spec 006) — RSS backfill cap, stats health metrics, and classifier coverage tracking. Co-ships with spec 014; shared v2 schema version bump.
  • specs/016-decision-journal.md: Decision journal for the intelligence tool — records decisions with context, rationale, and signal references; FTS search; CLI commands (add/list/search).
  • specs/017-archobs-team-analysis.md: Author/team analysis for archobs — git author extraction, per-cluster author distribution, bus factor, knowledge concentration (HHI), and show team CLI.
  • specs/018-archobs-fitness-check.md: Architecture fitness check for archobs — CI-gatable archobs check command evaluating file risk, cluster leakage/cohesion/risk_mean, and bus factor against configurable thresholds.
  • specs/019-classifier-training-data.md: Classifier training data (amends specs 006, 013) — reservoir sampling, standalone training SQLite databases, CLI commands (generate/label/progress/next), and agent skill workflow for subagent-driven topic classification.
  • specs/020-mechanics-consolidation.md: Collapse Mechanics stage into Design — move pattern skills to design/references, eliminate Mechanics from taxonomy, add role field to Define-stage manifest entries.
  • specs/decisions/: ADR-style decision records (see specs/decisions/000-template.md):
  • 001: Workflow-stage taxonomy
  • 002: Code vs system pattern terms
  • 003: Repo name → enterprise-software-playbook
  • 004: Triage boundary wrappers / decision tree
  • 005: Add security hardening skill

  • 006: Review protocol for code reviews

  • 009: V2 skill names and navigation

  • 010: Move skills under skills/ folder
  • 011: Explicit system model and feedback discipline
  • 012: Build guardrails for validation and packaging
  • 013: Metadata index and scaffolding
  • 014: Structured-thinking probes for core skills
  • 015: Vendor archobs tool
  • 016: Collapse Mechanics stage into Design
  • 017: Make archobs provider, manifest, and no-data trust states explicit
  • specs/templates/: Copy/paste templates for app-repo integration, CI quality gates, and service spec bundles.