Skip to content

v0.3.0 — MCP Truth Layer, Brownfield Backfill & One-Command Onboarding

Choose a tag to compare

View all tags
@benwu95 benwu95 released this 17 Jun 05:03
0.3.0
f660150

Prospec v0.3.0

v0.2.1 made the knowledge layer self-sustaining. v0.3.0 opens it up and grounds
it in code: a read-only MCP server lets any agent query project truth — even
without prospec skills installed; brownfield code can now backfill its own behavioral
specs; onboarding collapses to a single command; and planning/implementation can pull
dependency-layer usage knowledge on demand from Context7. Plus a deep source-hardening
pass that doubled the test suite.

192 files changed · +19,440 / −2,227 · 20 merged PRs (#18–#37)

✨ Headline features

prospec mcp serve — read-only MCP truth layer (new)

A stdio MCP server exposes project architecture truth, spec truth, dependency
direction, playbook, and knowledge freshness (the same frozen contract as
prospec check). Any harness's agent can query truth even without prospec skills
installed — the knowledge moat decouples from skill deployment. Per-request re-reads
stay fresh, realpath sandboxing blocks reads outside the repo, and it's purely
additive: when the server isn't running, everything works as before. (BL-033)

Reverse-spec extraction — brownfield WHAT-layer backfill (new)

/prospec-backfill-spec reverse-extracts a behavioral Feature Spec draft from
existing code (source = code, not a design tool) for modules with no spec coverage.
It records behavior, never intent, stages a draft for human verify-and-promote,
and never writes the trust zone. (BL-032)

prospec quickstart — one-command onboarding (new)

Brownfield onboarding collapses into a single command (init + agent sync), then the
agent-side /prospec-quickstart finishes the job — localizing skill triggers and
generating AI Knowledge. (OPT-A4)

On-demand dependency-layer knowledge (Context7)

plan / implement can now optionally inject dependency-layer usage knowledge from
Context7 when third-party libraries are touched — untrusted, graceful, and never
enters the cache-stable prefix. (BL-034)

🔬 Knowledge & scanning

  • raw-scan multi-language detection — project scan now detects backend languages
    plus C/C++/Swift    , beyond the original frontend set. (#33)
  • knowledge init --raw-scan-only — deterministic knowledge re-scan collapsed into
    a single flag (introduced as knowledge refresh, then folded into init). (#32, #35)

🧪 Quality & hardening

  • Self-contained verify/review references — agent-skills heuristics are now vendored
    in, so verify and review no longer depend on external skill availability. (#24)
  • Source five-axis review remediation — 32 confirmed findings fixed across two
    rounds. (#26, #27)
  • Centralized index-column schema, archive sibling-reference fix, and
    capability→feature migration cleanup. (#22, #23, #29)
  • Constitution now requires bulleted commit bodies and aligns git conventions. (#25)

📈 Tests & CI

  • v8 coverage wired into CI with a per-PR coverage summary comment. (#34)
  • All four coverage metrics raised above 90%; the suite grew 839 → 1,622 tests. (#37)
  • README restructured into an onboarding-first funnel. (#19)

📊 Compared to v0.2.1

v0.2.1 v0.3.0
Tests 839 1,622
CLI commands + check · measure + mcp serve · quickstart
MCP truth layer — read-only stdio server
Brownfield specs — reverse-spec backfill (/prospec-backfill-spec)
Dependency knowledge — on-demand Context7 injection
raw-scan languages frontend + backend · C/C++/Swift
Coverage gate — >90% (4 metrics) + per-PR CI summary

⬆️ Upgrade notes

Run prospec agent sync to pick up the new skills (/prospec-backfill-spec,
/prospec-quickstart) and updated templates. Optionally start the truth layer with
prospec mcp serve for any MCP-capable agent.

Merged PRs

  • #18 local MCP server (BL-033)
  • #19 README onboarding-first funnel
  • #20 multi-local MCP server
  • #21 skill/source optimization pass (2026-06-13)
  • #22 centralize index-column schema
  • #23 fix archive sibling reference
  • #24 self-contained verify/review references
  • #25 require bulleted commit bodies; align git conventions
  • #26 remediate src/ five-axis review findings (32 confirmed)
  • #27 round-2 source review remediation
  • #28 on-demand Context7 dependency-layer knowledge (BL-034)
  • #29 capability-to-feature migration cleanup
  • #30 prospec quickstart one-command onboarding (OPT-A4)
  • #31 reverse-spec extraction for brownfield WHAT-layer (BL-032)
  • #32 deterministic knowledge refresh command
  • #33 raw-scan backend + C/C++/Swift detection
  • #34 v8 coverage + per-PR coverage summary
  • #35 collapse knowledge refresh into knowledge init --raw-scan-only
  • #36 extract input=code reverse-spec into standalone /prospec-backfill-spec
  • #37 raise all 4 coverage metrics above 90%
Assets 2
Loading