What problem does it solve? Managing Design documents in an AI-driven development workflow requires consistent rules for creating new files, appending sections, and replacing existing sections by heading, plus correct draft/accepted lifecycle handling. This Skill centralizes those rules and provides a deterministic script for heading search so section replacement does not depend on LLM guesswork. ## Core Features & Use Cases - Three Operation Modes: CREATE new Design files with complete frontmatter (title, status: draft, created, updated), APPEND sections to existing Designs, and UPDATE sections via target_area heading matching. - Deterministic target_area Search: The bundled TypeScript script search-target-area.ts finds matching Markdown headings across Design files and returns JSON results, with defined behavior for multiple matches (warning) and no matches (skip with follow-up). - Lifecycle and Placement Rules: Applies draft/accepted status rules, resolves placement for new versus existing Designs, and checks ADF-COVERS declaration blocks during design-save. - Use Case: During a case-ready workflow, an agent needs to update the "Error Handling" section of an existing Design document. The Skill locates the exact heading via the script, replaces only that section, and preserves the document's existing status. ## Quick Start Ask the agent to update the target_area section of a Design document under docs/designs using the design file manager rules and its search-target-area script.
