Skip to content

v1.0.0 — the campaign release

Choose a tag to compare

View all tags
@Ian-Louw Ian-Louw released this 05 Jul 15:58
v1.0.0
1c59249

Potion is a lean project framework for Claude Code: eleven skills, two agents, one hook.
The filesystem is the memory, plans are prompts, and nothing is "done" without evidence.
This release was built by potion running on itself — the full campaign record is committed at .potion/.

1.0.0 — 2026-07-05

The campaign release: potion brewed itself. .potion/ in this repo is the
live record — design, three phases, two first-cycle pass verdicts so far
(01-harden and 02-empower, both cycle 1, zero gaps). The audits and fixes
below were executed by potion's own loop: workers, blind verifiers, refuter
panels.

01-harden — six-lens audit

  • 119 agents over 27 files (10 finders per lens, 3-refuter adversarial
    panels, refute-by-default), full coverage, no finders lost
  • 60 raw findings → 42 unique; 25 confirmed by the panels; 11 refuted
  • 20 behavioral defects fixed across 6 plans / 14 commits; 5 style findings
    accepted with reasons on record. Highlights:
    • Verifier never emits VERIFIED — the orchestrator is the single promotion
      point
    • Ratchet checks take their own check-{source} key, so newest-wins dedup
      can no longer shadow a lock
    • init gained a real new-cycle procedure (and PROJECT.md its ## Phases
      section)
    • Lossless pause↔resume: closed-vocab status captured and restored
    • Gap acceptance is user-only
    • One law canon
    • Install modes that work (skills-dir mode removed)

02-empower — six mechanisms, every one citing dogfood evidence (Law 10)

  • evidence/ convention — canonical home for runtime proof artifacts,
    referenced by path from VERIFICATION.md
  • Check-runner contract — POSIX sh from repo root, trimmed-stdout vs exit N
    semantics; kills the || true hack
  • Build-freshness precondition — verify confirms the running app corresponds
    to HEAD before judging behavior
  • Learnings delivery — planners grep learnings.jsonl into TECHNICAL NOTES;
    worker digests carry matching entry keys
  • Concern→Parked routing — non-gap findings land in STATE.md's Parked list;
    nothing evaporates
  • Continuity freshness — any skill that moves position refreshes the
    Session-continuity block

03-polish

  • README truth-checked against HEAD and given a stranger-ready
    "Quickstart: your first brew"
  • This release
Assets 2
Loading