Skip to content

v0.2.1 — Knowledge Flywheel, Drift Checker & Scale-Aware Planning

Choose a tag to compare

View all tags
@benwu95 benwu95 released this 12 Jun 09:59
0.2.1
8c820b1

Prospec v0.2.1

v0.2.0 closed two feedback loops (adversarial review + lesson promotion).
v0.2.1 makes the knowledge layer self-sustaining — lessons are now harvested
automatically at archive time, knowledge ↔ code drift is detected deterministically
in CI, and planning scales itself to the size of the change. Plus a token measurement
harness so prompt-cache claims are measured, not guessed.

153 files changed · +8,485 / −621 · 6 merged PRs (#12–#17)

✨ Headline features

Knowledge flywheel — archive auto-harvest (new)

/prospec-archive now auto-harvests lessons from each completed change into a
version-controlled ledger (BL-029) — no manual /prospec-learn trigger needed to
collect; promotion still requires explicit human approval. Backed by a new
Constitution Principle 5 (READMEs stay current; SHOULD), so knowledge freshness
is a graded rule, not a habit.

prospec check — deterministic drift checker with CI gate (new)

A new CLI command detects knowledge ↔ code drift deterministically (BL-030) —
stale module READMEs, missing index entries, broken module-map references — and
fails CI when knowledge falls behind the code. Drift stops being something you
notice; it becomes something the pipeline blocks.

Scale-aware task contract (quick mode)

Planning now adapts to change size (BL-004): small changes get a lightweight
fast path instead of the full ceremony, while large changes keep the complete
story → plan → tasks contract. Same gates, right-sized overhead.

🔬 Measurement & performance

  • prospec measure — a multi-provider token measurement harness with a
    read-only report CLI, so context-budget and caching claims are backed by numbers.
  • Static-first skill startup loading — skill prompts reordered for
    cache-stable prefixes, improving prompt-cache hit rates across sessions.

🌐 Language Policy

  • init now offers language selection, seeding a Constitution Language Policy
    rule (AI-generated docs in your language; code, identifiers, and git commit
    messages always in English    ).

📚 Knowledge & quality gates

  • Knowledge-sync gate at archive (BL-038) — /prospec-archive's Entry Gate now
    blocks archiving until module knowledge is synced.
  • Playbook grew three human-approved rules: PB-001 (structure-aware,
    mutation-verified assertions), PB-002 (lifecycle full-path scan),
    PB-003 (claim ↔ implementation consistency).

🐞 Fixes

  • ANSI color is now disabled for non-TTY stdout (clean output in pipes/CI).
  • CI gets its pnpm version from the packageManager field (no drift).

📊 Compared to v0.2.0

v0.2.0 v0.2.1
Tests 549 839
CLI commands init · sync · change · knowledge + check · measure
Lesson collection manual via /prospec-learn auto-harvest at archive
Knowledge freshness verify-time audit + deterministic CI drift gate
Task contract one-size scale-aware (quick mode)
Constitution 4 principles 5 (+ README freshness)

⬆️ Upgrade notes

Run prospec agent sync to pick up the updated skill templates (scale-aware
contract, archive gates, flywheel harvest). Optionally wire prospec check
into CI as the drift gate.

Merged PRs

  • #12 init language selection & Language Policy
  • #13 token measurement harness + static-first startup loading
  • #14 knowledge-sync gate at archive (BL-038)
  • #15 scale-aware task contract / quick mode (BL-004)
  • #16 deterministic drift checker with CI gate (BL-030)
  • #17 knowledge flywheel — archive auto-harvest (BL-029)
Assets 2
Loading