# Intel Store Schema Version: 1.0.0 Path: `.design/intel/` (gitignored - runtime data only) ## Overview The intel store is a set of flat JSON files (slices) that index the design surface. Each slice is an independent file. Agents read slices they need; the updater rewrites only changed slices. Slices are rebuilt by `scripts/build-intel.cjs` (full initial build) and refreshed on-demand by the `gdd-intel-updater` agent (incremental updates when run by the user or a skill that spawns it). The store is **not auto-current**: it reflects the last invocation of build-intel or the updater. Skills that depend on fresh intel should invoke the updater first or treat slice timestamps as best-effort. ## Slice Definitions ### files.json Index of all design-surface files tracked in the project. ```json { "generated": "", "git_hash": "", "files": [ { "path": "skills/scan/SKILL.md", "type": "skill", "mtime": "", "size_bytes": 1240, "git_hash": "" } ] } ``` `type` values: `skill`, `agent`, `reference`, `connection`, `script`, `hook`, `config`, `test`, `other` --- ### exports.json Named exports from each file (frontmatter `name:` fields, command names, agent names). ```json { "generated": "", "exports": [ { "file": "skills/scan/SKILL.md", "kind": "skill", "name": "gdd-scan", "command": "/gdd:scan" }, { "file": "agents/design-verifier.md", "kind": "agent", "name": "design-verifier" } ] } ``` `kind` values: `skill`, `agent`, `reference`, `other` --- ### symbols.json Headings, section anchors, and named concepts extracted from markdown files. ```json { "generated": "", "symbols": [ { "file": "reference/accessibility.md", "heading": "## WCAG Contrast Thresholds", "level": 2, "anchor": "wcag-contrast-thresholds", "line": 42 } ] } ``` --- ### tokens.json Design token references found across skill and agent files (color, spacing, typography, radius). ```json { "generated": "", "tokens": [ { "file": "skills/style/SKILL.md", "token": "--color-primary", "category": "color", "line": 18, "context": "Check `--color-primary` against WCAG AA" } ] } ``` `category` values: `color`, `spacing`, `typography`, `radius`, `shadow`, `motion`, `other` --- ### components.json Component names referenced or defined across design surface files. ```json { "generated": "", "components": [ { "file": "skills/design/SKILL.md", "component": "Button", "role": "reference", "line": 31 } ] } ``` `role` values: `definition`, `reference`, `example` --- ### patterns.json Design patterns classified by concern, extracted from design-pattern-mapper output and reference docs. ```json { "generated": "", "patterns": [ { "name": "color-system", "category": "color-system", "source_file": "reference/heuristics.md", "description": "Semantic color token usage pattern" } ] } ``` `category` values: `color-system`, `spacing-system`, `typography-system`, `component-styling`, `layout`, `interaction`, `other` --- ### dependencies.json Intra-project @-references and explicit reads-from relationships between files. ```json { "generated": "", "dependencies": [ { "from": "skills/verify/SKILL.md", "to": "reference/accessibility.md", "kind": "at-reference", "line": 7 }, { "from": "agents/design-verifier.md", "to": "reference/heuristics.md", "kind": "reads-from", "line": 3 } ] } ``` `kind` values: `at-reference`, `reads-from`, `skill-calls-agent`, `agent-calls-agent` --- ### decisions.json Architectural decisions extracted from DESIGN-CONTEXT.md and `.design/DESIGN-DECISIONS.md` (if present). ```json { "generated": "", "decisions": [ { "id": "D-01", "summary": "Use Figma MCP for token extraction — merge not replace grep results", "source_file": ".design/DESIGN-CONTEXT.md", "line": 12, "date": "2026-04-18" } ] } ``` --- ### debt.json Design debt items extracted from `.design/DESIGN-DEBT.md`. ```json { "generated": "", "debt": [ { "id": "DEBT-01", "summary": "Spacing token --space-4 used inconsistently across 3 components", "severity": "medium", "source_file": ".design/DESIGN-DEBT.md", "line": 8 } ] } ``` `severity` values: `high`, `medium`, `low` --- ### graph.json Cross-reference graph: nodes are files, edges are dependency relationships from dependencies.json. ```json { "generated": "", "nodes": [ { "id": "skills/verify/SKILL.md", "type": "skill", "name": "gdd-verify" } ], "edges": [ { "from": "skills/verify/SKILL.md", "to": "reference/accessibility.md", "kind": "at-reference" } ] } ``` --- ### agent-tiers.json Runtime-neutral tier index per agent; populated by `gdd-intel-updater` so downstream tooling reads tier information without re-parsing every agent's markdown frontmatter. Both the model-tier (`opus|sonnet|haiku`) and the equivalent runtime-neutral reasoning class (`high|medium|low`) are emitted side-by-side using the locked equivalence map (opus↔high, sonnet↔medium, haiku↔low). ```json { "generated": "", "agents": [ { "name": "design-planner", "default_tier": "opus", "reasoning_class": "high" }, { "name": "design-verifier-gate", "default_tier": "haiku", "reasoning_class": "low" } ] } ``` Consumers: router, budget enforcer, multi-runtime tier resolver. Validation: every agent in `agents/*.md` (except README.md) MUST appear exactly once. Written atomically (.tmp + rename) when the updater runs; absent on a fresh checkout. ## Incremental Update Rules 1. On each run, compare current file `mtime` and `git_hash` against `files.json` entries. 2. Only re-extract slices for files that changed. 3. Always regenerate `graph.json` after any dependency slice update. 4. `generated` timestamp in each slice reflects the last time that slice was written. ## Usage by Agents Agents read slices conditionally using the `@.design/intel/.json (if present)` pattern. This allows graceful degradation when the intel store has not been built yet. Example conditional read block in an agent: ``` @.design/intel/tokens.json (if present) @.design/intel/components.json (if present) ```