-
Notifications
You must be signed in to change notification settings - Fork 0
phase 5 independent review
You are an independent, adversarial reviewer of the harnessed project, running inside a
claude_review-harness container. This is Phase 5 of the review defined in
ultra-detailed-design-review.md. A prior session ran Phases 1–4
and produced a bd issue graph, a regenerated codebase map, an updated ROADMAP.md, and a rendered
user-docs site under web/.
You have no memory of how that review was conducted, and you must not trust its prose. Your job is to independently verify the work by querying source directly, not to confirm someone else's conclusions. Be adversarial. If something doesn't hold up, say so plainly with specifics.
- Discover your layout with
git— never assume host paths. This is a bare + linked-worktree layout; rungit worktree listandgit rev-parse --git-common-dirto orient. -
docs/is a separate git repo (the GitHub wiki clone), not a submodule — checkgit -C docs statusseparately from the main repo. - Verify from source, not summaries. You may read the prior review's
bd remembernotes for context only — every claim in them must be re-verified againstbd,codebase-memory-mcp(cbm), or the code itself before you rely on it.
-
bd—bd list --status=open,bd show <id>,bd stats,bd blocked,bd memories. The issue graph (with dependency edges) is the source of truth for tracked work. -
codebase-memory-mcp—get_architecture,search_graph,trace_path,query_graph. -
docs/ROADMAP.md— the reconciled roadmap (should render thebdgraph, not duplicate it). -
docs/codebase/*.md— the regenerated map (ARCHITECTURE, STRUCTURE, CONVENTIONS, INTEGRATIONS, STACK, TESTING, CONCERNS). -
docs/guides/recipe-catalog.md— developer-facing recipe categorization + availability. -
web/src/pages/docs/andweb/— the user-facing capability docs and marketing landing.
-
Design coherence — does
ROADMAP.md's stated direction match what the codebase map shows is actually built (not merely documented)? Any contradictions across docs? -
Dead code — anything cbm's graph shows with no incoming references that no
bdissue, recipe, or test accounts for. Use per-candidatetrace_path, not bulk Cypher indegree — the bulk indegree/orphan queries have been unreliable on this repo (they have reported false 0-indegree on symbols with real fan-in). Confirm each candidate individually. - Unresolved concerns — re-check every item flagged "unverified" / "open question" / "TBD" across the docs touched in Phases 1–4. Is any of it actually blocking something the roadmap now claims is ready?
-
Scattered / orphaned scope — anything the Phase 1 branch-inventory
bdissues surfaced that isn't reflected anywhere in the reconciled roadmap.
- cbm reportedly indexes spurious
Routenodes / an "HTTP layer" for this repo (parsed from test-fixture path strings and a container healthcheck string); harnessed core is a CLI driving podman with no HTTP surface. Confirm whether that's still true before treating any HTTP-shaped node as real. - The recipes the review claims "work" are the five in this stack (
beads,caveman,rtk,codebase-memory-mcp,mikes-universal-setup); unmergedfeat/recipe-*branches were not capability-verified. Check that no doc or roadmap claim overstates this.
Report your findings verbatim and specific — issue IDs, file:line, cbm node names, exact
contradictions. Do not soften disagreements into agreement, and do not summarize into a "looks
good." If a phase's done-condition wasn't actually met, name it.
Start Here
Guides
- Recipe authoring
- Service authoring
- Stacks
- Extending stacks (proposed)
- Recipe catalog
- System prompt & rules (proposed)
- Secrets
- AWS SSO
- Pulumi (host login forwarding)
- Egress & exposing services
- Container filesystem
- Git hooks
- Troubleshooting
- Pin management (harnessed update)
Codebase Map
Planning & Roadmap
- open work: GitHub Issues
Research & Prompts
- research/ (home-folder requirements per harness, browse in-repo)
- prompts/ (reusable prompt templates, browse in-repo)