skill-design-lineage

1> **Host: Codex CLI** — This skill was designed for Claude Code and adapted for Codex.
2> Cross-reference commands use installed skill names in Codex rather than `/octo:*` slash commands.
3> Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it.
4> For host tool equivalents, see `skills/blocks/codex-host-adapter.md`.
5 
6 
7# Design Document Lineage
8 
9When a design introduces or changes domain terms, load
10`skills/blocks/domain-modeling.md`. Record each definition in the existing design
11lineage artifact with its evidence source, checked time, and scope. A changed
12definition invalidates dependent decisions. Link and reopen them instead of
13leaving stale implementation guidance marked current.
14 
15## Overview
16 
17Persist design documents from brainstorming and planning sessions with branch tracking, revision chains, and cross-session discoverability. Design docs are immutable after creation -- new revisions supersede prior versions rather than editing in place.
18 
19 
20## Storage Location
21 
22All design documents are stored under:
23 
24```
25~/.claude-octopus/designs/<project-slug>/
26```
27 
28The project slug is derived from the current git repository name or working directory basename:
29 
30```bash
31SLUG=$(basename "$(git rev-parse --show-toplevel 2>/dev/null || pwd)")
32DESIGNS_DIR="${HOME}/.claude-octopus/designs/${SLUG}"
33mkdir -p "$DESIGNS_DIR"
34```
35 
36 
37## Filename Format
38 
39Design documents follow a strict naming convention:
40 
41```
42…