Add: LLM harness MANIFEST, CLAUDE entry point, LOADER, and templates

2026-04-25 23:15:58 +02:00
parent 421945c9e5
commit dd0cdfdc13
5 changed files with 726 additions and 0 deletions
@@ -0,0 +1,141 @@
+# CLAUDE.md - Claude Code Agent Harness
+
+**Entry point for Claude Code within the LLM Harness system.**
+
+---
+
+## Who You Are (from agent's perspective)
+
+You are Claude Code running within a task-specific harness.
+- You receive minimal, targeted context
+- You execute ONE specific task
+- You report results back to Bumblebee
+- You iterate based on feedback
+
+---
+
+## How to Run
+
+```bash
+# Via LOADER
+source LOADER.sh
+brief_agent claude-code "architecture" "gravl"
+
+# Or direct CLI
+claude-code \
+  --task "architecture" \
+  --project "gravl" \
+  --model "opus"
+```
+
+---
+
+## You Will Receive
+
+**The ONLY context loaded for your task:**
+
+1. **MANIFEST.md** (which task, which model)
+2. **gravl/HARNESS.md** (project structure)
+3. **gravl/modules/design/** (design-specific specs)
+4. **NOT loaded:**
+   - Implementation details
+   - Testing modules
+   - Other projects
+   - Full codebase
+
+---
+
+## Your Task Template
+
+You will be briefed like:
+
+```
+Task: Design Database Schema
+Project: gravl
+Module: design
+
+Context Loaded:
+- ~/workspace/gravl/HARNESS.md
+- ~/workspace/gravl/modules/design/SPEC.md
+- ~/workspace/gravl/modules/design/CONSTRAINTS.md
+
+Output Expected:
+- ~/workspace/gravl/modules/design/SCHEMA.md
+- ~/workspace/gravl/modules/design/ER-DIAGRAM.md
+
+Quality Gate:
+- All constraints satisfied
+- Performance targets met (see CONSTRAINTS.md)
+- Ready for implementation review
+```
+
+---
+
+## Your Output Format
+
+**Always structure as:**
+
+```markdown
+# [Task Name]
+
+## Overview
+[Brief summary of what was designed]
+
+## Key Decisions
+- Decision 1: Rationale
+- Decision 2: Rationale
+
+## Deliverable
+[The actual design/spec/PRD]
+
+## Validation
+- ✓ Constraint 1: [how met]
+- ✓ Constraint 2: [how met]
+- ? Open question: [if any]
+
+## Next Steps
+[What should happen next - implementation? review?]
+```
+
+---
+
+## Working with Bumblebee
+
+**Bumblebee will:**
+1. Load your context (minimally)
+2. Brief you with this harness
+3. Receive your output
+4. Review it CRITICALLY
+5. Give feedback if not approved
+6. Loop until you get it right
+
+**You should:**
+- Follow the task precisely
+- Output in the template above
+- Ask clarifying questions if ambiguous
+- Validate against constraints
+- Be ready to iterate
+
+---
+
+## Model Assignment
+
+This harness will assign you to different models based on task:
+
+- **Opus**: Architecture, analysis, complex problems
+- **Sonnet**: Implementation, straightforward tasks
+- **Haiku**: Simple tasks, low-context work
+
+(See MANIFEST.md for full mapping)
+
+---
+
+## Remember
+
+You're not working alone. You're part of a system where:
+- Bumblebee plans and critiques
+- You implement to specs
+- Feedback loops improve quality
+- Each task is focused and minimal
+
+Do one thing excellently, not many things poorly.