feat(F100): Reference Integrity CI Gate + One-Time Cleanup

.claude/commands.json

@@ -160,12 +160,9 @@
   "agents": {
     "orchestrator": "agents/orchestrator.md",
     "reviewer": "agents/reviewer.md",
-    "builder": "agents/builder.md",
     "deployer": "agents/deployer.md",
     "tester": "agents/qa.md",
     "architect": "agents/architect.md",
-    "analyst": "agents/analyst.md",
-    "developer": "agents/developer.md",
     "implementer": "agents/implementer.md",
     "spec-reviewer": "agents/spec-reviewer.md",
     "security": "agents/security.md",

.codex/INSTALL.md

@@ -16,7 +16,7 @@ Project skills source of truth lives in `prompts/skills/` (this repo). Tool fold
    ```bash
    sdp init --auto
    ```
-3. Use `@build 00-XXX-YY` or `sdp plan`, `sdp apply`, `sdp log trace` per [CLAUDE.md](../CLAUDE.md).
+3. Use `@build 00-XXX-YY` or `sdp plan`, `sdp apply`, `sdp log trace` per [AGENTS.md](../AGENTS.md).
 
 If you want the CLI only, use:
 
@@ -32,7 +32,7 @@ curl -sSL https://raw.githubusercontent.com/fall-out-bug/sdp/main/install.sh | s
 ├── agents/      # Project-level agent symlink
 └── skills/
     ├── README.md
-    └── sdp/     # Project-level skills sourced from prompts/skills
+    └── {skill}/ # Per-skill symlinks to prompts/skills/{skill}
 
 ~/.codex/
 └── skills/      # User-level skills (persistent)

.codex/skills/README.md

@@ -1,9 +1,10 @@
 # Project-level skills (Codex)
 
-SDP project skills are defined in `prompts/skills/` (source of truth). This folder contains symlinks for Codex compatibility.
+SDP project skills are defined in `prompts/skills/` (source of truth). This folder contains per-skill symlinks for Codex compatibility.
 
+- **@init** — Initialize SDP in a project. See `prompts/skills/init/SKILL.md`.
 - **@build** — Execute workstream (TDD, guard). See `prompts/skills/build/SKILL.md`.
 - **@design** — Plan workstreams. See `prompts/skills/design/SKILL.md`.
 - **@review** — Multi-agent quality review. See `prompts/skills/review/SKILL.md`.
 
-Full list: `prompts/skills/` (build, design, feature, guard, oneshot, review, tdd, etc.).
+Full list: `prompts/skills/` (init, build, design, feature, guard, oneshot, review, tdd, etc.).

.codex/skills/beads

@@ -0,0 +1 @@
+../../prompts/skills/beads/

.codex/skills/bugfix

@@ -0,0 +1 @@
+../../prompts/skills/bugfix/

.codex/skills/build

@@ -0,0 +1 @@
+../../prompts/skills/build/

.codex/skills/ci-triage

@@ -0,0 +1 @@
+../../prompts/skills/ci-triage/

.codex/skills/debug

@@ -0,0 +1 @@
+../../prompts/skills/debug/

.codex/skills/deploy

@@ -0,0 +1 @@
+../../prompts/skills/deploy/

.codex/skills/design

@@ -0,0 +1 @@
+../../prompts/skills/design/

.codex/skills/discovery

@@ -0,0 +1 @@
+../../prompts/skills/discovery/

.codex/skills/feature

@@ -0,0 +1 @@
+../../prompts/skills/feature/

.codex/skills/go-modern

@@ -0,0 +1 @@
+../../prompts/skills/go-modern/

.codex/skills/guard

@@ -0,0 +1 @@
+../../prompts/skills/guard/

.codex/skills/hotfix

@@ -0,0 +1 @@
+../../prompts/skills/hotfix/

.codex/skills/idea

@@ -0,0 +1 @@
+../../prompts/skills/idea/

.codex/skills/init

@@ -0,0 +1 @@
+../../prompts/skills/init/

.codex/skills/issue

@@ -0,0 +1 @@
+../../prompts/skills/issue/

.codex/skills/oneshot

@@ -0,0 +1 @@
+../../prompts/skills/oneshot/

.codex/skills/protocol-consistency

@@ -0,0 +1 @@
+../../prompts/skills/protocol-consistency/

.codex/skills/prototype

@@ -0,0 +1 @@
+../../prompts/skills/prototype/

.codex/skills/reality

@@ -0,0 +1 @@
+../../prompts/skills/reality/

.codex/skills/reality-check

@@ -0,0 +1 @@
+../../prompts/skills/reality-check/

.codex/skills/review

@@ -0,0 +1 @@
+../../prompts/skills/review/

.codex/skills/strataudit

@@ -0,0 +1 @@
+../../prompts/skills/strataudit/

.codex/skills/tdd

@@ -0,0 +1 @@
+../../prompts/skills/tdd/

.codex/skills/think

@@ -0,0 +1 @@
+../../prompts/skills/think/

.codex/skills/ux

@@ -0,0 +1 @@
+../../prompts/skills/ux/

.codex/skills/verify-workstream

@@ -0,0 +1 @@
+../../prompts/skills/verify-workstream/

.codex/skills/vision

@@ -0,0 +1 @@
+../../prompts/skills/vision/

.cursor/README.md

@@ -22,6 +22,6 @@ Use `@` prefix to invoke skills:
 
 ## See Also
 
-- [CLAUDE.md](../CLAUDE.md) - Full protocol
+- [AGENTS.md](../AGENTS.md) - Agent instructions and quality gates
 - [prompts/skills/](../prompts/skills/) - Canonical skill definitions
 - [.claude/skills/](../.claude/skills/) - Claude compatibility symlink

.cursor/worktrees.json

@@ -1,11 +1,9 @@
 {
   "setup_commands_unix": [
-    "cd sdp-plugin && go mod download 2>/dev/null || echo 'Go modules not configured'",
-    "echo '✅ Worktree ready (Go project)'"
+    "echo 'Worktree ready (SDP project)'"
   ],
   "setup_commands_windows": [
-    "cd sdp-plugin && go mod download 2>nul || echo Go modules not configured",
-    "echo Worktree ready (Go project)"
+    "echo Worktree ready (SDP project)"
   ],
-  "description": "Template for SDP project worktree setup. Go-first project."
+  "description": "Template for SDP project worktree setup."
 }

.github/workflows/reference-check.yml

@@ -0,0 +1,22 @@
+name: Reference Integrity Check
+
+on:
+  pull_request:
+    branches: [main, dev]
+  push:
+    branches: [main, dev]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  check-references:
+    name: Check References
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Run reference integrity check
+        run: sh scripts/check-references.sh

AGENTS.md

@@ -14,13 +14,15 @@ bd sync               # Sync with git
 
 ## Quality Gates
 
-Before pushing code changes:
-
-```bash
-go build ./...              # must succeed
-go test ./...               # must pass
-go vet ./...                # no issues
-```
+Before pushing code changes, run the appropriate gates for your project's language:
+
+| Language | Build | Test | Lint |
+|----------|-------|------|------|
+| Go | `go build ./...` | `go test ./...` | `go vet ./...` |
+| Python | `pip install .` | `pytest` | `ruff check .` |
+| Node.js | `npm run build` | `npm test` | `npm run lint` |
+| Rust | `cargo build` | `cargo test` | `cargo clippy` |
+| Java | `mvn compile` | `mvn test` | `mvn checkstyle:check` |
 
 For Go changes, follow the canonical `@go-modern` skill in `prompts/skills/go-modern/SKILL.md` and prefer modern stdlib idioms when they preserve behavior.
 

CLAUDE.md

@@ -5,7 +5,8 @@ AI-native dev with workstreams, gates, TDD.
 ## Decision Tree
 
 ```
-New? → @vision → @reality → @feature
+New? → @init → @vision → @reality → @feature
+Demo? → sdp demo
 No → State? → @reality --quick
 WS? → @oneshot <id>
 No → @feature "X"
@@ -24,7 +25,10 @@ No → @feature "X"
 ## Try
 
 ```bash
-go install github.com/fall-out-bug/sdp/sdp-plugin/cmd/sdp@latest
+sdp demo                    # Guided walkthrough
+# or install manually:
+# go install github.com/fall-out-bug/sdp/sdp-plugin/cmd/sdp@latest
+@init
 @feature "X"
 @build 00-001-01
 ```

CONTRIBUTING.md

@@ -79,7 +79,7 @@ sh scripts/test-install-project.sh
 ## What to Edit
 
 - Edit `prompts/` for prompt or agent behavior.
-- Do not hand-edit `.claude/`, `.cursor/`, `.opencode/`, or `.codex/skills/sdp` as source files.
+- Do not hand-edit `.claude/`, `.cursor/`, `.opencode/`, or `.codex/skills/` as source files.
 - Edit `sdp-plugin/` for CLI behavior.
 - Update docs when public behavior changes.
 

docs/ADOPTION.md

@@ -222,7 +222,7 @@ sh sdp/scripts/uninstall.sh
 
 **What is removed:**
 
-- Symlinks in `.claude/skills`, `.claude/agents`, `.cursor/skills`, `.cursor/agents`, `.opencode/skills`, `.opencode/agents`, `.codex/skills/sdp`, `.codex/agents`
+- Symlinks in `.claude/skills`, `.claude/agents`, `.cursor/skills`, `.cursor/agents`, `.opencode/skills`, `.opencode/agents`, `.codex/skills/*` (legacy `.codex/skills/sdp` also cleaned), `.codex/agents`
 - SDP-installed files: `.claude/commands.json`, `.codex/INSTALL.md`, `.codex/skills/README.md`
 - Git hooks pointing to SDP (`pre-commit`, `pre-push`)
 - SDP entries from `.gitignore`

install.sh

@@ -33,11 +33,29 @@ for arg in "$@"; do
     esac
 done
 
+detect_ide() {
+    if [ "$SDP_IDE" != "auto" ] && [ -n "$SDP_IDE" ]; then
+        echo "$SDP_IDE"
+        return
+    fi
+    # Auto-detect from existing config files
+    if [ -f ".cursorrules" ] || [ -d ".cursor" ]; then echo "cursor"
+    elif [ -d ".codex" ]; then echo "codex"
+    elif [ -d ".claude" ]; then echo "claude"
+    elif [ -d ".opencode" ]; then echo "opencode"
+    elif [ -d ".zed" ] || [ -f ".zed/settings.json" ]; then echo "zed"
+    elif [ -d ".warp" ]; then echo "warp"
+    else echo "auto"
+    fi
+}
+
 run_remote_script() {
     name="$1"
     shift
     url="https://raw.githubusercontent.com/${SDP_REPO}/${SDP_REF}/scripts/${name}"
-    curl -fsSL "$url" | SDP_REPO="$SDP_REPO" SDP_REF="$SDP_REF" SDP_IDE="${SDP_IDE:-auto}" sh -s -- "$@"
+    DETECTED_IDE=$(detect_ide)
+    echo "Detected IDE: ${DETECTED_IDE}"
+    curl -fsSL "$url" | SDP_REPO="$SDP_REPO" SDP_REF="$SDP_REF" SDP_IDE="${SDP_IDE:-$DETECTED_IDE}" sh -s -- "$@"
 }
 
 if [ "$BINARY_ONLY" = "1" ]; then

prompts/README.md

@@ -14,7 +14,7 @@ Compatibility adapters are provided as symlinks:
 - `.cursor/agents` -> `../prompts/agents`
 - `.opencode/skills` -> `../prompts/skills`
 - `.opencode/agents` -> `../prompts/agents`
-- `.codex/skills/sdp` -> `../../prompts/skills`
+- `.codex/skills` -> per-skill individual symlinks (e.g. `.codex/skills/build` -> `../../prompts/skills/build`)
 - `.codex/agents` -> `../prompts/agents`
 
 Edit only `prompts/*` to avoid prompt drift across tools.

prompts/skills/feature/SKILL.md

@@ -192,6 +192,18 @@ Proceed? [y/n]
 
 > **Note:** `--dry-run` and `--yes` are orthogonal to skill mode flags (`--default`, `--quick`, `--auto`). They can be combined with any mode (e.g. `@feature "X" --quick --dry-run`).
 
+## Completion
+
+When all workstreams are created and verified, output:
+
+```
+@feature complete. Feature {ID}: {count} workstreams created.
+  Aggregate: 00-{FFF}-00
+  Leaves: 00-{FFF}-01 .. 00-{FFF}-{NN}
+
+Next: @build 00-{FFF}-01  or  @oneshot F{XX}
+```
+
 ## See Also
 
 @discovery — Product discovery gate | @idea — Requirements | @ux — UX research | @design — Workstream planning | @build — Execute leaf workstream | @oneshot — Execute all ready leaf workstreams