How wyze69-sys/speccouncil works
SpecCouncil accepts a design, freezes it as evidence, runs four bounded specialist reviews, validates cited findings, persists results, and presents a deterministic report. The graph also shows the server-side preparation and worker path. The README documents the end-to-end contract; sampled source confirms key API, storage, review, and provider boundaries. Some internal dispatch details are unsampled, so those links are omitted rather than inferred.
Main entry points: runner.go Role runner · store.go Review store · provider.go Provider boundary · server.go HTTP API
Components 23
Entry and ingestion
- HTTP API
internal/api/server.go - Snapshot input
internal/api/snapshot_provider.go - Document ingestion
internal/ingest/parser.go - Frozen evidence
internal/evidence/snapshot.go
Review execution
- Role runner
internal/review/runner.go - Prompt assembly
internal/review/prompt.go - Finding validation
internal/review/validate.go - Provider boundary
internal/provider/provider.go - Cline adapter
internal/provider/cline/cline.go - Scripted provider
internal/provider/fake/fake.go - Requirements review
internal/review/runner.go - Architecture review
internal/review/runner.go - QA review
internal/review/runner.go - Security review
internal/review/runner.go
Persistence and workers
- Review store
internal/storage/sqlite/store.go - Job preparation
internal/storage/sqlite/prepare.go - Worker supervision
internal/worker/supervise.go - Role dispatch
internal/worker/dispatch.go - Result publication
internal/storage/sqlite/publish.go
Reporting
- Report composition
internal/review/composer.go - Report and status reads
internal/storage/sqlite/read.go
Other components
- Design submitter
- Cline service
Connections 23
- Design submitter → HTTP API: submits design
README.md - HTTP API → Review store: submits review job
internal/api/server.go - Snapshot input → Document ingestion: parses snapshot
internal/api/snapshot_provider.go - Document ingestion → Frozen evidence: freezes evidence
- Review store → Job preparation: prepares job
internal/storage/sqlite/prepare.go - Frozen evidence → Role runner: supplies shared snapshot
README.md - Worker supervision → Role dispatch: coordinates work
- Role dispatch → Role runner: runs roles
- Role runner → Prompt assembly: assembles prompts
internal/review/runner.go - Role runner → Provider boundary: calls provider
internal/review/runner.go - Role runner → Finding validation: validates responses
README.md - Provider boundary → Cline adapter: implemented by
internal/provider/cline/cline.go - Provider boundary → Scripted provider: implemented by
internal/provider/fake/fake.go - Cline adapter → Cline service: sends model request
internal/provider/cline/cline.go - Role runner → Requirements review: reviews requirements
README.md - Role runner → Architecture review: reviews architecture
README.md - Role runner → QA review: reviews testability
README.md - Role runner → Security review: reviews security
README.md - Finding validation → Result publication: accepts cited findings
README.md - Result publication → Review store: persists results
README.md - Role runner → Report composition: composes deterministic report
- Review store → Report and status reads: reads stored results
internal/storage/sqlite/read.go - Report and status reads → HTTP API: serves report
README.md