@assistkick/create 1.7.0 → 1.9.0

package/templates/skills/product-system/kanban.json

@@ -0,0 +1,304 @@
+{
+  "feat_001": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_002": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_003": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_004": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_005": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_006": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_007": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_008": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_009": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_010": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_011": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_012": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_013": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_014": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_015": {
+    "column": "done",
+    "rejection_count": 1,
+    "notes": [
+      {
+        "from": "in_review",
+        "text": "REJECTED: Breaks feat_012 (Neighborhood Focus Mode, currently in QA). The implementation: (1) Deleted neighborhood_focus.test.js — the entire test file for feat_012; (2) Removed the getNeighborIds method from GraphRenderer; (3) Removed the this.links instance property; (4) Changed selectNode to only highlight the clicked node instead of the node + its neighbors. The feat_015 changes themselves (NODE_SHAPES, nodeShapePath, shape-based rendering) are correct and tests pass. But the fix is to preserve the neighborhood focus logic: keep getNeighborIds, keep this.links, keep the neighbor-aware opacity in selectNode, and keep neighborhood_focus.test.js. Only change circles to path shapes — do not alter selection/focus behavior.",
+        "timestamp": "2026-02-26T21:21:25.658Z"
+      }
+    ]
+  },
+  "feat_016": {
+    "column": "done",
+    "rejection_count": 1,
+    "notes": [
+      {
+        "from": "in_review",
+        "text": "REJECTED: feat_016 implementation itself is correct (edge colors, labels, toggle, arrows all work), but the branch deletes unrelated code: (1) Removes entire NodeSearch integration from app.js and index.html (feat_020 search container HTML, import, init, setNodes, closeResults, handleSearchSelect all deleted), (2) Deletes test files: node_search.test.js (feat_020), node_sizing.test.js (feat_014), zoom_pan.test.js (feat_019). Fix: keep only feat_016 additions, do not remove search functionality or other features' test files.",
+        "timestamp": "2026-02-26T21:38:10.666Z"
+      }
+    ]
+  },
+  "feat_017": {
+    "column": "done",
+    "rejection_count": 1,
+    "notes": []
+  },
+  "feat_018": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_019": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_020": {
+    "column": "done",
+    "rejection_count": 1,
+    "notes": [
+      {
+        "id": "580ee91f",
+        "text": "The UI is there, but it does not work",
+        "created_at": "2026-02-27T07:37:42.201Z",
+        "updated_at": "2026-02-27T07:37:42.201Z"
+      }
+    ]
+  },
+  "feat_021": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_022": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_023": {
+    "column": "done",
+    "rejection_count": 1,
+    "notes": [
+      {
+        "id": "8cba0018",
+        "text": "rejection 1",
+        "created_at": "2026-02-26T18:08:57.398Z",
+        "updated_at": "2026-02-26T18:08:57.398Z"
+      }
+    ]
+  },
+  "feat_025": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_026": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_027": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_028": {
+    "column": "done",
+    "rejection_count": 1,
+    "notes": [
+      {
+        "id": "0b8c863c",
+        "text": "The search should appear inside the legend card, just above the legend section",
+        "created_at": "2026-02-27T10:34:30.774Z",
+        "updated_at": "2026-02-27T10:34:30.774Z"
+      }
+    ]
+  },
+  "feat_029": {
+    "column": "done",
+    "rejection_count": 1,
+    "notes": [
+      {
+        "from": "in_review",
+        "text": "REJECTED: graph_legend.js has 3 unresolved merge conflicts (<<<<<<< HEAD / ======= / >>>>>>> main markers at lines 29, 95, and 155). The application will not load. Issues: (1) Constructor conflict: HEAD adds collapsed/hiddenTypes/onTypeToggle but loses edgesCollapsed property needed by existing legend collapse feature. (2) buildHTML conflict: HEAD adds type-toggle-container and changes legend-header to legend-toggle but loses the legend-header div from main. (3) Method conflict: HEAD adds bindTypeToggleChips/getHiddenTypes/toggleCollapse but deletes toggleEdgesCollapse which is called in render(). The merge must be resolved to combine BOTH the new type toggle chip feature AND the existing edges-collapsed functionality. All three conflict regions need manual resolution that preserves main's edgesCollapsed logic while adding the new hiddenTypes toggle chips.",
+        "timestamp": "2026-02-27T11:20:49.508Z"
+      }
+    ]
+  },
+  "feat_030": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_031": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_024": {
+    "column": "done",
+    "moved_at": "2026-02-27T09:05:26.762Z",
+    "notes": [
+      {
+        "id": "62ed7a0d",
+        "text": "When the user tries to manually move a card from todo to in progress in the kanban board they can see the possible drop columns higlighed but when they drop the feature in the in progress nothing happens, the backend shows the following logs\n\n[09:18:13.261] [API] GET /api/kanban\n[09:18:15.088] [ROUTER] POST /api/kanban/feat_023/move\n[09:18:15.089] [API] POST /api/kanban/feat_023/move\n[09:18:15.089] [MOVE] feat_023 → target: in_progress\n[09:18:15.090] [MOVE] feat_023: current=todo allowed=[]\n[09:18:15.090] [MOVE] REJECT: todo → in_progress not allowed\n[09:18:17.388] [ROUTER] POST /api/kanban/feat_023/move\n[09:18:17.388] [API] POST /api/kanban/feat_023/move\n[09:18:17.389] [MOVE] feat_023 → target: in_progress\n[09:18:17.390] [MOVE] feat_023: current=todo allowed=[]\n[09:18:17.390] [MOVE] REJECT: todo → in_progress not allowed\n[09:18:27.086] [ROUTER] GET /api/graph\n[09:18:27.086] [API] GET /api/graph\n[09:18:28.986] [ROUTER] GET /api/kanban\n[09:18:28.986] [API] GET /api/kanban\n[09:18:30.604] [ROUTER] POST /api/kanban/feat_023/move\n[09:18:30.604] [API] POST /api/kanban/feat_023/move\n[09:18:30.605] [MOVE] feat_023 → target: in_progress\n[09:18:30.605] [MOVE] feat_023: current=todo allowed=[]\n[09:18:30.605] [MOVE] REJECT: todo → in_progress not allowed\n[09:18:45.489] [ROUTER] POST /api/kanban/feat_023/move\n[09:18:45.490] [API] POST /api/kanban/feat_023/move\n[09:18:45.490] [MOVE] feat_023 → target: in_progress\n[09:18:45.491] [MOVE] feat_023: current=todo allowed=[]\n[09:18:45.491] [MOVE] REJECT: todo → in_progress not allowed\n\nAll transitions should be allowed for human users in the kanban board.",
+        "created_at": "2026-02-27T09:20:44.258Z",
+        "updated_at": "2026-02-27T09:20:44.258Z"
+      }
+    ],
+    "rejection_count": 1
+  },
+  "feat_032": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_034": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": []
+  },
+  "feat_035": {
+    "column": "done",
+    "rejection_count": 1,
+    "notes": [],
+    "moved_at": "2026-02-27T14:11:18.076Z"
+  },
+  "feat_036": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": [],
+    "moved_at": "2026-02-27T13:42:38.833Z"
+  },
+  "feat_033": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": [],
+    "moved_at": "2026-02-27T13:42:30.978Z"
+  },
+  "feat_037": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": [],
+    "moved_at": "2026-02-27T13:43:07.183Z"
+  },
+  "feat_038": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": [],
+    "moved_at": "2026-02-27T13:53:02.202Z"
+  },
+  "feat_039": {
+    "column": "done",
+    "rejection_count": 1,
+    "notes": [
+      {
+        "from": "qa",
+        "text": "Bug found: feat_039 implementation is completely missing. The inline notes UI from feat_022 was never replaced with the side sheet. See feat_042 for detailed investigation and fix guidance.",
+        "timestamp": "2026-02-27T18:14:32.514Z"
+      }
+    ],
+    "moved_at": "2026-02-27T18:24:26.331Z"
+  },
+  "feat_040": {
+    "column": "qa",
+    "rejection_count": 1,
+    "notes": [
+      {
+        "from": "in_review",
+        "text": "Reviewer process died silently during parallel pipeline run with feat_041. Worktree and branch cleaned up. Ready for re-run.",
+        "timestamp": "2026-02-28T07:42:01.496Z"
+      }
+    ],
+    "moved_at": "2026-02-28T08:45:51.004Z"
+  },
+  "feat_041": {
+    "column": "qa",
+    "rejection_count": 0,
+    "notes": [],
+    "moved_at": "2026-02-27T18:50:01.745Z"
+  },
+  "feat_042": {
+    "column": "done",
+    "rejection_count": 0,
+    "notes": [],
+    "moved_at": "2026-02-27T18:24:29.757Z"
+  },
+  "feat_043": {
+    "column": "todo",
+    "rejection_count": 0,
+    "notes": [],
+    "moved_at": "2026-02-28T08:31:18.178Z"
+  },
+  "feat_044": {
+    "column": "todo",
+    "rejection_count": 0,
+    "notes": [],
+    "moved_at": "2026-02-28T08:31:21.696Z"
+  },
+  "feat_045": {
+    "column": "todo",
+    "rejection_count": 0,
+    "notes": [],
+    "moved_at": "2026-02-28T08:31:24.631Z"
+  },
+  "feat_046": {
+    "column": "todo",
+    "rejection_count": 0,
+    "notes": [],
+    "moved_at": "2026-02-28T08:31:27.401Z"
+  }
+}

package/templates/skills/product-system/nodes/comp_001.md

@@ -0,0 +1,56 @@
+---
+id: comp_001
+type: component
+name: Graph Engine
+status: defined
+priority: high
+created_at: '2026-02-26T12:13:09.364Z'
+updated_at: '2026-02-26T12:21:39.425Z'
+---
+## Description
+Core data layer managing graph.json — the central index of all nodes and edges. Handles atomic reads/writes using temp file + rename. Stores node metadata (id, type, name, status, completeness, open_questions_count, file path, timestamps) and typed edges (from, relation, to).
+
+## Responsibilities
+- Load and save graph.json atomically (temp file + rename)
+- Maintain the nodes array with metadata (id, type, name, status, completeness, open_questions_count, file, timestamps)
+- Maintain the edges array with typed relations (from, relation, to)
+- Generate sequential IDs per node type (e.g. feat_001, feat_002)
+- Provide lookup functions for nodes by id and edges by endpoints
+- Initialize empty graph structure for new projects
+- Update node metadata when completeness or status changes
+
+## Tech
+- Node.js fs module for file I/O
+- JSON.parse / JSON.stringify for serialization
+- Atomic write pattern: write to .tmp file then fs.renameSync
+- Path resolution relative to skill base directory
+
+## Exposes
+- loadGraph() → full graph object
+- saveGraph(graph) → atomic write to graph.json
+- findNode(id) → node metadata or null
+- nextId(type) → next sequential ID string
+- addNodeMeta(node) → appends to nodes array
+- updateNodeMeta(id, updates) → patches node metadata
+- addEdgeMeta(edge) → appends to edges array
+- removeEdgeMeta(from, rel, to) → removes matching edge
+
+## Consumes
+- lib/constants.js for type prefix mappings
+- Node.js fs and path modules
+
+## Resolved Questions
+
+## Notes
+
+## Relations
+- implemented_with ← feat_001 (Node CRUD Operations)
+- implemented_with ← feat_002 (Edge Management)
+- implemented_with ← feat_006 (Search and Discovery)
+- implemented_with ← feat_008 (Index Rebuild)
+- reads_writes → data_001 (graph.json)
+- depends_on ← comp_007 (CLI Tools Layer)
+- governed_by → dec_002 (Atomic File Writes)
+- implemented_with ← feat_041 (Graph Coherence Review Process)
+- relates_to ← feat_044 (Turso Connection and Database Layer)
+- relates_to ← feat_046 (Remove Local File Dependencies)

package/templates/skills/product-system/nodes/comp_002.md

@@ -0,0 +1,57 @@
+---
+id: comp_002
+type: component
+name: Markdown System
+status: defined
+priority: high
+created_at: '2026-02-26T12:13:10.832Z'
+updated_at: '2026-02-26T12:21:39.463Z'
+---
+## Description
+Handles parsing and serializing node markdown files. Uses gray-matter for YAML frontmatter. Provides section-based read/write/append/move operations. Markdown files are the source of truth; graph.json is derived metadata.
+
+## Responsibilities
+- Parse node markdown files into structured {frontmatter, sections} objects
+- Serialize structured data back to markdown with YAML frontmatter
+- Read, write, and append content to named sections (## headers)
+- Move lines between sections (for question resolution)
+- Generate blank section templates per node type
+- Derive metadata (completeness, open_questions_count, status) from content
+- Preserve section ordering and formatting on write
+
+## Tech
+- gray-matter library for YAML frontmatter parsing and serialization
+- Custom section parser splitting body on ## headers
+- String manipulation for section content operations
+- Regex for checkbox counting in open questions
+
+## Exposes
+- readNode(filepath) → {frontmatter, sections}
+- writeNode(filepath, fm, sections) → serialized .md file
+- getSection(sections, name) → section content string
+- setSection(sections, name, content) → updated sections
+- appendToSection(sections, name, line) → creates section if missing
+- moveLineAcrossSections(sections, from, to, line) → for question resolution
+- deriveMetadata(fm, sections, type) → {completeness, open_questions_count, status}
+- templateSections(type) → blank section map for node type
+
+## Consumes
+- gray-matter (npm) for frontmatter parsing
+- lib/constants.js for section templates and scoring rules
+- lib/completeness.js for score calculation
+- Node.js fs and path modules
+
+## Resolved Questions
+
+## Notes
+
+## Relations
+- implemented_with ← feat_001 (Node CRUD Operations)
+- implemented_with ← feat_003 (Question Lifecycle)
+- implemented_with ← feat_008 (Index Rebuild)
+- reads_writes → data_002 (Node Markdown Files)
+- depends_on ← comp_007 (CLI Tools Layer)
+- governed_by → dec_001 (Markdown as Source of Truth)
+- governed_by → dec_005 (Bidirectional Relation Recording)
+- implemented_with → tech_002 (gray-matter)
+- relates_to ← feat_046 (Remove Local File Dependencies)

package/templates/skills/product-system/nodes/data_001.md

@@ -0,0 +1,51 @@
+---
+id: data_001
+type: data_entity
+name: graph.json
+status: defined
+priority: high
+created_at: '2026-02-26T12:13:45.234Z'
+updated_at: '2026-02-26T12:21:39.691Z'
+---
+## Description
+Central index file storing all node metadata and edges. Contains version, project info, nodes array (id, type, name, status, completeness, open_questions_count, file, timestamps), and edges array (from, relation, to). Written atomically via temp file + rename.
+
+## Fields
+- version: string (currently "1.0")
+- project.name: string
+- project.description: string
+- project.created_at: ISO 8601 timestamp
+- project.updated_at: ISO 8601 timestamp
+- nodes[]: array of node metadata objects
+- nodes[].id: string (type prefix + sequential number, e.g. feat_001)
+- nodes[].type: string (one of 12 valid types)
+- nodes[].name: string
+- nodes[].status: draft | partially_defined | defined
+- nodes[].completeness: number 0.0 to 1.0
+- nodes[].open_questions_count: integer
+- nodes[].file: string (relative path to .md file)
+- nodes[].created_at: ISO 8601 timestamp
+- nodes[].updated_at: ISO 8601 timestamp
+- edges[]: array of edge objects
+- edges[].from: string (source node ID)
+- edges[].relation: string (one of 11 valid relations)
+- edges[].to: string (target node ID)
+
+## Used By
+- comp_001 (Graph Engine) — reads and writes this file
+- All CLI tools via Graph Engine
+- get_status, get_gaps, search_nodes for metadata queries
+- rebuild_index regenerates this file from markdown
+
+## Resolved Questions
+
+## Notes
+
+## Relations
+- reads_writes ← comp_001 (Graph Engine)
+- reads_writes ← feat_021 (Kanban Board View)
+- relates_to ← dec_016 (SQLite Index for Scale)
+- reads_writes ← feat_009 (Graph Visualization Web UI)
+- reads_writes ← feat_038 (Kanban Card Copy Button)
+- reads_writes ← feat_041 (Graph Coherence Review Process)
+- relates_to ← feat_045 (Data Migration Script)

package/templates/skills/product-system/nodes/data_002.md

@@ -0,0 +1,40 @@
+---
+id: data_002
+type: data_entity
+name: Node Markdown Files
+status: defined
+priority: high
+created_at: '2026-02-26T12:13:47.815Z'
+updated_at: '2026-02-26T12:21:39.730Z'
+---
+## Description
+Individual .md files in nodes/ directory, one per specification node. Use YAML frontmatter (id, type, name, status, priority, timestamps) + section-based body (Description, Acceptance Criteria, Open Questions, Resolved Questions, Notes, Relations, plus type-specific sections). These are the source of truth.
+
+## Fields
+- Frontmatter (YAML):
+- id: string (matches graph.json node ID)
+- type: string (node type)
+- name: string (display name)
+- status: draft | partially_defined | defined
+- priority: low | medium | high | blocking
+- created_at: ISO 8601 timestamp
+- updated_at: ISO 8601 timestamp
+- Body sections (## headers):
+- Type-specific required sections (vary by node type)
+- Resolved Questions: completed question-answer pairs
+- Notes: session notes and annotations
+- Relations: auto-populated edge descriptions
+
+## Used By
+- comp_002 (Markdown System) — reads and writes these files
+- All CLI tools that modify or display node content
+- rebuild_index reads these to regenerate graph.json
+- The AI interviewer and product owner review these for specification content
+
+## Resolved Questions
+
+## Notes
+
+## Relations
+- reads_writes ← comp_002 (Markdown System)
+- relates_to ← feat_045 (Data Migration Script)

package/templates/skills/product-system/nodes/data_004.md

@@ -0,0 +1,38 @@
+---
+id: data_004
+type: data_entity
+name: kanban.json
+status: defined
+priority: medium
+created_at: '2026-02-26T16:17:04.615Z'
+updated_at: '2026-02-27T17:48:49.256Z'
+---
+## Description
+Stores implementation tracking state separate from the spec graph. Structure per feature: { featureId: { column: 'todo|in_progress|qa|done', rejection_count: number, notes: [{ id, text, created_at, updated_at, addressed: boolean }] } }. Only features with spec status=defined are represented. The 'addressed' field on notes tracks whether the debugger agent has investigated a given issue.
+
+## Fields
+
+## Used By
+
+## Resolved Questions
+
+## Notes
+> Session 13: Added 'addressed' boolean field to note objects for feat_040 debug pipeline tracking.
+
+## Relations
+- reads_writes ← feat_021 (Kanban Board View)
+- reads_writes ← feat_022 (QA Rejection Notes)
+- reads_writes ← feat_023 (QA Rejection Counter)
+- reads_writes ← feat_024 (Free-Form Kanban Column Transitions)
+- reads_writes ← feat_025 (Retry Attempt Label on Kanban Cards)
+- relates_to ← dec_016 (SQLite Index for Scale)
+- reads_writes ← feat_036 (All Features on Kanban Board)
+- reads_writes ← feat_038 (Kanban Card Copy Button)
+- reads_writes ← feat_039 (QA Issue Reporting Side Sheet)
+- reads_writes ← feat_040 (Debug-First Pipeline Step for QA Issues)
+- relates_to ← feat_045 (Data Migration Script)
+
+## Acceptance Criteria
+- Stores column, rejection_count, and notes array per feature
+- File is auto-created when the kanban is first accessed
+- New defined features default to todo column with rejection_count 0

package/templates/skills/product-system/nodes/dec_001.md

@@ -0,0 +1,34 @@
+---
+id: dec_001
+type: decision
+name: Markdown as Source of Truth
+status: defined
+priority: high
+created_at: '2026-02-26T12:13:57.346Z'
+updated_at: '2026-02-28T08:31:00.783Z'
+---
+## Description
+Node markdown files are the canonical data source. graph.json is derived metadata that can be regenerated via rebuild_index. This ensures human-readable specs and enables manual editing when needed.
+
+## Rationale
+Markdown files are human-readable, diffable in git, and editable with any text editor. Making them the source of truth means the system degrades gracefully — even if graph.json is corrupted, all specification content is preserved in individual files and can be rebuilt via rebuild_index.
+
+## Alternatives Considered
+- Database (SQLite/JSON-DB): More structured but loses human readability and git diffability
+- graph.json as source of truth: Simpler but single point of failure and harder to manually inspect
+- YAML-only files: More structured than markdown but less flexible for free-form content
+
+## Affects
+- comp_002 (Markdown System) — primary consumer of this decision
+- feat_008 (Index Rebuild) — enables recovery from graph.json corruption
+- All tools must go through markdown.js for content changes
+
+## Resolved Questions
+
+## Notes
+> Session 15: Superseded by dec_018 (Turso Database as Source of Truth). Markdown is no longer stored as local files. Content lives in Turso database TEXT columns. The rationale (human-readability, git-diffability) is preserved conceptually — content is still markdown format — but the storage layer has changed.
+
+## Relations
+- governed_by ← comp_002 (Markdown System)
+- relates_to ← dec_016 (SQLite Index for Scale)
+- relates_to ← dec_018 (Turso Database as Source of Truth)

package/templates/skills/product-system/nodes/dec_016.md

@@ -0,0 +1,32 @@
+---
+id: dec_016
+type: decision
+name: SQLite Index for Scale
+status: defined
+priority: high
+created_at: '2026-02-27T07:55:59.733Z'
+updated_at: '2026-02-28T08:30:58.271Z'
+---
+## Description
+When the project grows beyond ~200-300 features, replace graph.json and kanban.json (the derived index files) with a SQLite database. Markdown files remain the source of truth (dec_001 unchanged). SQLite replaces only the derived index layer — rebuild_index would regenerate the SQLite DB from markdown instead of regenerating graph.json. This gives indexed queries, proper joins for edge lookups, and eliminates the full-file read/parse/write cycle on every tool call. Trigger point: when tool operations start feeling slow, likely around 200-300 features with 1000+ edges.
+
+## Rationale
+JSON files require full read/parse/modify/serialize/write on every operation. At 500+ nodes with 2500+ edges, graph.json reaches ~500KB-1MB, causing noticeable latency. SQLite provides indexed lookups, partial reads, and atomic row-level writes. Markdown stays as source of truth (dec_001), so git diffability and human readability are preserved. SQLite only replaces the derived index — rebuild_index regenerates it from markdown.
+
+## Alternatives Considered
+1. **Keep JSON files** — works now at 65 nodes, degrades at 200-300+. Current approach.\n2. **Split graph.json per type** — e.g. features.json, decisions.json. Reduces per-file size but adds complexity and cross-type queries still need multiple files.\n3. **Full SQLite (replace markdown too)** — loses git diffability, human readability, and the rebuild safety net. Over-migration.
+
+## Affects
+- comp_001 (Graph Engine) — graph.js would use better-sqlite3 instead of JSON read/write\n- feat_008 (Index Rebuild) — rebuild_index regenerates SQLite DB instead of graph.json\n- data_001 (graph.json) — replaced by graph.db\n- data_004 (kanban.json) — absorbed into graph.db as a kanban table\n- All CLI tools — transparent if graph.js API stays the same
+
+## Resolved Questions
+
+## Notes
+> Session 14: The scale argument is now secondary. The primary driver is correctness under concurrent pipeline access. feat_040's reviewer crashed because feat_041's stash/merge/pop disrupted kanban.json mid-write. JSON files are entangled with git state — any git operation on the working tree can corrupt concurrent readers/writers. A database decouples data access from git entirely, making concurrent pipelines safe. This elevates the migration from 'nice-to-have at scale' to 'needed for pipeline reliability now'.
+> Session 15: Scope expanded significantly. Now using Turso (hosted LibSQL) instead of local better-sqlite3, with Drizzle ORM. Markdown files no longer stored locally — full content stored in Turso TEXT columns. dec_018 supersedes dec_001 as the source-of-truth decision. S3 dropped — Turso alone handles all persistence.
+
+## Relations
+- relates_to → dec_001 (Markdown as Source of Truth)
+- relates_to → data_001 (graph.json)
+- relates_to → data_004 (kanban.json)
+- relates_to ← dec_018 (Turso Database as Source of Truth)

package/templates/skills/product-system/nodes/feat_008.md

@@ -0,0 +1,30 @@
+---
+id: feat_008
+type: feature
+name: Index Rebuild
+status: defined
+priority: medium
+created_at: '2026-02-26T12:13:39.739Z'
+updated_at: '2026-02-26T12:19:57.630Z'
+---
+## Description
+Regenerates graph.json from all node markdown files. Recovers from manual file edits or corruption. Preserves valid edges, removes edges referencing deleted nodes. Supports dry-run mode.
+
+## Acceptance Criteria
+- Regenerates graph.json from all node markdown files in nodes/ directory
+- Preserves valid edges where both endpoint nodes still exist
+- Removes edges referencing deleted nodes
+- Supports --dry-run mode to preview changes without writing
+- Recalculates completeness and status for all nodes
+
+## Open Questions
+
+## Resolved Questions
+
+## Notes
+
+## Relations
+- implemented_with → comp_001 (Graph Engine)
+- implemented_with → comp_002 (Markdown System)
+- relates_to ← feat_041 (Graph Coherence Review Process)
+- relates_to ← feat_046 (Remove Local File Dependencies)