planning

Architecture decision records (ADRs) require consistent numbering and status tracking across creation, archiving, and updates. This Skill automates ID generation, enforces proper directory routing, manages lifecycle transitions, and maintains frontmatter structure so you maintain a searchable, organized record without manual intervention.

Yes. This Skill applies frontmatter templates, auto-numbering, and cross-document linking to ADRs, FDPs, action plans, and reports. It enforces status transitions, supersedes relationships, and addenda management, keeping all planning documents structurally consistent without editing locked files.

The Skill automates archive handling and inter-document relationships through configuration-driven lifecycle management. It moves documents to archive directories, maintains links between related records, and tracks supersedes relationships, so your planning history remains intact and queryable.

Configure vibe-hacker.json to define directory structure and numbering rules for each document type (ADR, FDP, AP, Report). The Skill reads this configuration and applies it when you create new documents, generating correct IDs and frontmatter automatically via the provided Python scripts.

The Skill applies structure to new documents you create going forward. It protects existing content through frontmatter parsing and status management, so you can integrate it incrementally into your workflow without disrupting your current planning documentation.