docs: two POC modes — branch vs standalone scratch project

- pocs.md: define both modes + per-POC assignment (POC-1/2 standalone at
  /workspace/alkgit-pocN, POC-3 branch mode); findings are the
  deliverable, POC source never merges to main
- sdd_process.md: phase 0 + POC Specialist sections cover both modes
- poc-specialist.md: mode determination up front, standalone environment
  section, 'stay in your lane' principle updated
- AGENTS.md: lifecycle status describes the two modes

Verified: none needed (markdown only)
This commit is contained in:
glm-5.3-flash committed 2026-09-19 17:35:58 +00:00
1 parent 4d3ec3cc63
commit b9ab5e4c9e
4 files changed
+88 -15

No files matched your search

+22 -6
View File
@@ -33,10 +33,19 @@ problems need investigation.
1. Capture vision and guiding principles
2. Research Specialist investigates options (`docs/research/` or external)
3. POC Specialist validates promising approaches (`.worktrees/research/`)
3. POC Specialist validates promising approaches
4. Document learnings
5. Converge on recommended approach
**POC placement (two modes)** — POC code never merges to main; the
deliverable is the findings write-up:
- **Branch mode** (POC builds on code in this repo): git branch off main,
work there, merge findings into research docs, drop the branch.
- **Standalone mode** (POC independent of this repo's code): scratch
project at `/workspace/<poc-name>`, outside the repo. Findings go into
`docs/research/` on main directly.
**Output**: Clear understanding of WHAT to build and WHY, with validated
approaches
@@ -89,7 +98,10 @@ WHAT, ADRs explain WHY, open questions track what's unresolved.
2. Coordinator spawns worktrees + sessions (via
`worktree({action: "spawn", ...})` or hub `coord.spawn` when available)
- Feature work: `.worktrees/feat/<task-id>/` → Implementation Specialist
- Research POCs: `.worktrees/research/<task-id>/` → POC Specialist
- Research POCs building on repo code: `.worktrees/research/<task-id>/`
→ POC Specialist (branch mode)
- Research POCs independent of repo code: standalone scratch project at
`/workspace/<poc-name>` → POC Specialist (standalone mode)
3. Coordinator injects task context into each session
4. Agents execute tasks with self-verification
5. On completion: agent notifies coordinator, updates task status, commits to
@@ -312,9 +324,11 @@ limited set (current, notify, status). No mode toggle required.
**Responsibility**: Create proof-of-concepts to validate technical approaches
before production implementation.
**Mode**: Primary (works in isolated research worktree)
**Mode**: Primary (branch mode: isolated research worktree; standalone
mode: scratch project outside the repo)
**Worktree Location**: `.worktrees/research/<task-id>/`
**Worktree Location**: `.worktrees/research/<task-id>/` (branch mode) or
`/workspace/<poc-name>` (standalone mode)
**Tools**:
@@ -324,8 +338,10 @@ before production implementation.
**Key Behaviors**:
- Create minimal POCs to validate hypotheses
- Work in isolated research worktrees
- Document findings and recommendations
- Branch mode: work in isolated research worktrees; standalone mode: work
in the scratch project only
- Document findings and recommendations (findings are the deliverable —
POC source is disposable and never merges to main)
- Timebox strictly - abandon if taking too long
- Be honest about limitations and blockers