1  # Alpha/Delta Protocol Context
 2  
 3  ## Quick Start
 4  - **Workers**: Use `CLAUDE-QUICK.md` for minimal context (~3KB)
 5  - **Modular rules**: `.claude/rules/` loads based on file paths
 6  - **MCP tools**: `ci_status`, `list_repos`, `git_status`, `cargo_check`
 7  - **Subagents**: orchestrator, worker, explorer, multi-model in `.claude/agents/`
 8  - **Cross-check**: `/cross-check <file>` for multi-model verification
 9  
10  ## Tech Stack
11  - **Core**: Rust binary `adnet` (AlphaVM + DeltaVM)
12  - **CI**: Forgejo Runner @ ci.ac-dc.network (native, no Docker)
13  - **VCS**: Forgejo (source.ac-dc.network) → auto-sync to Radicle
14  
15  ## Workspace
16  All repos in `/home/devops/working-repos/`:
17  | Category | Repos |
18  |----------|-------|
19  | VMs | alphavm, deltavm |
20  | Nodes | alphaos, deltaos, adnet |
21  | Core | acdc-core, ac-dc |
22  | Language | adl, adl-examples |
23  | SDK/Web | sdk, ci-dashboard |
24  | Docs | alpha-delta-context |
25  
26  ## Key Paths
27  | Path | Purpose |
28  |------|---------|
29  | `components/` | Source of truth (cspec) |
30  | `components/_registry/` | Manifest, dependencies |
31  | `project/implementation/machine/status.cspec` | Implementation status |
32  | `sessions/*.cspec` | Session logs |
33  | `.claude/hooks/` | PreToolUse/PostToolUse hooks |
34  | `.claude/agents/` | Custom subagents |
35  | `.claude/rules/` | Path-specific rules |
36  
37  ## Operational Protocol
38  1. Load `status.cspec` for context sync
39  2. Use MCP tools for CI/git operations
40  3. Use cspec files (not .md) for implementation
41  4. Log significant work to `sessions/`
42  5. Push to Forgejo only (Radicle auto-syncs)
43  
44  ## Modular Rules (auto-loaded by path)
45  - `rules/components.md` - Component workflow
46  - `rules/ci-infra.md` - CI/CD rules
47  - `rules/rust-dev.md` - Rust conventions
48  - `rules/anti-patterns.md` - What NOT to do
49  - `rules/aliases.md` - Command aliases
50  
51  ## Model Routing (Default)
52  
53  See `.claude/model-routing.json` for full configuration.
54  
55  | Task Type | Model | Reason |
56  |-----------|-------|--------|
57  | CI repair | **DeepSeek Coder** | Routine fixes, low cost |
58  | Shadow runner | **DeepSeek Coder** | Infrastructure automation |
59  | Test writing | **DeepSeek Coder** | Pattern-based generation |
60  | Cross-check | **Sonnet** | Verification of DeepSeek output |
61  | Architecture | **Opus** | Complex design decisions |
62  | Security review | **Opus + Sonnet** | Multi-model verification |
63  
64  **Commands:**
65  | Command | Model | Purpose |
66  |---------|-------|---------|
67  | `/ci-repair <repo>` | DeepSeek | Fix CI failures |
68  | `/cross-check <file>` | Sonnet + DeepSeek | Verify code |
69  
70  **Environment required**:
71  ```bash
72  export DEEPSEEK_API_KEY="..."   # Required for ci-repair, shadow-runner
73  export ANTHROPIC_API_KEY="..."  # For Sonnet cross-check (or use session)
74  ```
75  
76  ## Critical Don'ts
77  - ❌ Push to Radicle directly (auto-syncs via CI)
78  - ❌ Use Docker in CI (native runners only)
79  - ❌ Edit .md docs directly (edit cspec, generate md)
80  - ❌ Load build-history/_archived/ (ignore)