skill-design-lineage

Persist immutable design documents with full revision history by storing them under ~/.claude-octopus/designs/<project-slug>/ with YAML frontmatter. This preserves a complete history of decisions without editing original files in place.

Immutable design lineage preserves design documents as permanent records after creation. New revisions supersede prior versions instead of modifying originals, ensuring complete auditability of design decisions across brainstorming and planning sessions.

Yes, cross-session discovery surfaces relevant design documents during flow-discovery and development. Designs persist under a standard project directory and remain accessible across sessions to maintain context for ongoing planning and define workflows.

Yes, YAML frontmatter with branch, user, created, and supersedes fields is required to enable branch tracking and revision chains. This metadata allows the system to link revisions and maintain full design history accurately.

Avoid in-place editing when you need strict auditability and traceability of design decisions. Use superseding revisions instead to preserve original documents, ensuring a verifiable chain of changes for compliance and historical review.