Skip to content

v0.3.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 11 Jun 01:09
· 39 commits to main since this release
v0.3.0
27168c9

v0.3.0

[0.3.0] — 2026-05-28

The "harness era" release. Adds the third orchestrator command (/init-harness) so any project can be bootstrapped in one go; frames the whole skill as an agent harness (Tejas Kumar vocabulary) and bakes lie-detection into the validator; lands 4 new references absorbed from Boris Cherny's Claude Code best practices + Tejas's harness talk (onboarding / verify-loop / ergonomics / deterministic-handlers). README gains a Mermaid lifecycle diagram so first-time readers see the 3-command shape in 10 seconds.

Added

  • references/onboarding.md — Day 1 protocol for any new contributor (human or AI agent): Q&A-only first day, anchor checklist (CLAUDE.md / CONTEXT.md / RESUME.md / iteration-journal / docs/superpowers/ / .claude/commands/), why edit-first fails, Day 2+ gradient to /ship. Includes the project-level shared .claude/commands/ schema (team-shared slash commands checked into source control, scope hierarchy user-personal vs project-shared vs org-shared). Adapted from Anthropic internal onboarding practice (Boris Cherny).
  • references/verify-loop.md — verify-loop as a named, first-class pattern. Three canonical loops (test / visual / runtime) with where each lives in this skill's cadence. Wiring template for any subagent dispatch. Anti-patterns (no-verify dispatch = self-grading = lies). Adapted from Boris Cherny's "Practical Tips for Claude Code".
  • references/ergonomics.md — Claude Code session ergonomics: 5 habits to internalize (# memory append, ! bash mode, shift-tab auto-accept, escape safe interrupt, drag-drop multimodal). Full reference for keybindings + session continuity + setup commands + claude -p SDK mode + multi-Claude parallelism rules. Sourced from Boris Cherny's talk + Anthropic internal usage.
  • commands/init-harness.md (new /init-harness slash command) — bootstrap a fresh or existing project to use this skill in one command. Detects stack (language / framework / DB / queue / auth / multi-tenant markers / timezone-sensitive code / layer split / CI), then generates CLAUDE.md with folder-map + policy keys + don't-do list, seeds CONTEXT.md / RESUME.md / iteration-journal.md / CHANGELOG.md, scaffolds project-shared .claude/commands/ (test-phase / start-stack / db-snapshot) and .claude/handlers/ (pre-flight lint / secret leak / migration safety / tenant isolation / auth / test-failure attribution). Idempotent — merges into existing files; never overwrites without explicit confirm. 4 human checkpoints (confirm stack / approve folder-map / approve policy keys + handler set / approve commit). --refresh re-detects + diffs against current state; --dry-run reports without writing. Realizes Tejas Kumar's "2027 = year of dynamic on-the-fly harnesses" vision in this skill's context.
  • references/init-harness.md — canonical spec consumed by /init-harness: detection signal table (every language / framework / DB / ORM / queue / auth marker and what it implies), merge strategy per generated artifact (CLAUDE.md by-section merge, CHANGELOG format conversion, handler-scaffold idempotency, etc.), handler scaffold templates per detected stack, generated .claude/commands/ skeleton format, idempotency guarantees, anti-patterns. Cross-references onboarding.md + builder-split.md + deterministic-handlers.md + changelog.md + output-format.md + context-md.md.
  • references/deterministic-handlers.md — harness-injected pre-step pattern (Tejas Kumar's "login handler" generalized). Pure code that runs every agent-loop iteration before the LLM acts; for failure modes with one right answer (auth, secrets, pre-flight lint, migration safety, tenant isolation, test-failure attribution). 6 canonical handler examples + discipline rules + wiring template into builder dispatch. Path-to-dynamic-handlers section sketches the 2027 step.
  • commands/release.md (new /release slash command) — automated release cut. Computes SemVer bump from CHANGELOG.md [Unreleased] content (Removed/BREAKING → MAJOR, Added/Changed → MINOR, Fixed/Security/Deprecated → PATCH), renames the section to [X.Y.Z] — YYYY-MM-DD with the today date, inserts a fresh [Unreleased] block, updates compare links, bumps both .claude-plugin/ manifests, validates, commits, tags, pushes, and watches the workflow + verifies the GitHub Release landed. One human checkpoint (confirm bump + version). Args: /release [auto|major|minor|patch].
  • references/release-process.md — canonical release-process spec consumed by /release: artifact inventory, SemVer bump table, per-release file updates, commit + tag conventions, workflow behavior on tag push, verification checklist, failure-mode recovery (including retroactive-tag flow for commits predating release.yml), cadence guidance.

Changed

  • SKILL.md Quick Reference + Mandatory Conventions + Red Flags + References now point at /release as the single entry point for cutting a release. Editing CHANGELOG / manifests / tags by hand is flagged as an anti-pattern (defeats the consistency the validator depends on).
  • SKILL.md adds an "This skill IS an agent harness" preamble framing the skill in Tejas Kumar's vocabulary (tool registry / guardrails / context management / agent loop / verify step / deterministic handlers / lie detection) — gives users vocabulary for what the skill is doing.
  • SKILL.md Quick Reference adds rows for: Day 1 onboarding, wiring a verify loop, writing a deterministic handler, # memory append for surprising-AI-assumption capture.
  • references/cadence.md step 2 (Validator) gains a mandatory "step 0: lie detection" pass — runs FIRST every validator invocation; cross-references Builder Summary claims against the diff + acceptance verifier report; false claims = CRITICAL. Catches the LLM-default-lying failure mode Tejas's harness demo surfaces.
  • SKILL.md Red Flags add: validator skipping lie-detection; builder claiming success the verifier didn't confirm.
  • scripts/commands-manifest.txt — adds release.md + init-harness.md to the synced command set.
  • README.md — adds harness framing paragraph; surfaces /init-harness + /release + Day 1 onboarding in "When to use" + "Using it"; file tree gains "onboarding + ergonomics" group at the top, "release" + "bootstrap" groups for release-process.md + init-harness.md, and init-harness.md + release.md alongside ship.md under commands/; Setup section now lists three slash commands (init-harness / ship / release); Development section's release flow replaced with single /release line + manual fallback.
  • SKILL.md Quick Reference adds a row for /init-harness (bootstrap fresh / existing projects). References list adds init-harness.md entry.
  • README.md gains a "TL;DR — the 3-command lifecycle" section right after the tagline, with a Mermaid flowchart (GitHub-native rendering) visualizing /init-harness → /ship → /release over the project timeline + the CHANGELOG [Unreleased] feedback into /release. Per-command checkpoint count + role surfaced inside each node. Below the diagram: bullet description per command, then a closing paragraph naming the inter-command discipline (CHANGELOG / labels / Conventional Commits / Validator + Acceptance Verifier + deterministic handlers). Sharpens the tagline from "brainstorm → ... → milestone-done" to "driven by 3 slash commands and a 10-step per-phase / 6-step per-task discipline." (Initial draft used ASCII art; replaced with Mermaid because GitHub renders it inline + it looks like a designed diagram, not a terminal screenshot.)

Full history: see CHANGELOG.md

Full Changelog: https://github.com/Victoriakaey/project-life-cycle/commits/v0.3.0

Assets 2
Loading