Commit Graph

1 Commits

  • feat(skills): add architecture-decision-records skill (#555)
    * feat(skills): add architecture-decision-records skill
    
    Adds a skill that captures architectural decisions made during coding
    sessions as structured ADR documents (Michael Nygard format).
    
    Features:
    - Auto-detects decision moments from conversation signals
    - Records context, alternatives considered with pros/cons, and consequences
    - Maintains numbered ADR files in docs/adr/ with an index
    - Supports ADR lifecycle (proposed → accepted → deprecated/superseded)
    - Categorizes decisions worth recording vs trivial ones to skip
    - Integrates with planner, code-reviewer, and codebase-onboarding skills
    
    Includes Antigravity support via .agents/skills/ and openai.yaml.
    
    * fix: address review feedback on ADR skill
    
    - Add missing "why did we choose X?" read-ADR trigger to .agents/ copy
    - Add canonical-reference link to .agents/ SKILL.md pointing to full version
    - Remove integration reference to non-existent codebase-onboarding skill
    
    * fix: add initialization step and sync .agents/ trigger
    
    - Add Step 1 to workflow: initialize docs/adr/ directory, README.md
      index, and template.md on first use when directory doesn't exist
    - Add "API design" to .agents/ alternatives trigger to match canonical
      version
    
    * fix: address ADR workflow gaps and implicit signal safety
    
    - Init step: seed README.md with index table header so Step 8 can
      append rows correctly on first ADR
    - Add read-path workflow: graceful handling when docs/adr/ is empty
      or absent ("No ADRs found, would you like to start?")
    - Implicit signals: add "do not auto-create without user confirmation"
      guard, tighten triggers to require conclusion/rationale not just
      discussion, remove overly broad "testing strategy" trigger
    
    * fix: require user confirmation before creating files
    
    - Canonical SKILL.md: init step now asks user before creating docs/adr/
    - .agents/ condensed version: add confirmation gate for implicit signals
      and explicit consent step before any file writes
    
    * fix: require user approval before writing ADR file, add refusal path
    
    * fix: remove .agents/ duplicate, keep canonical in skills/
    
    ---------
    
    Co-authored-by: vazidmansuri005 <vazidmansuri005@users.noreply.github.com>