Phased, not dated. Each phase is independently useful and shippable.
- Publish
SPEC.md: trajectory, ledger, version formats. - Implementation-independent. This is the piece that could go to the AAIF.
init,template,edit,render,lint.log,diff,status,commit,revert,tag,blame.- No LLM required. Useful and adoptable on day one.
- Claude Code capture via
Stophook +transcript_path. learn,pending,promote,reject,savings.- The token-savings USP, demoable.
- Project-local SessionEnd connectors: Codex, Claude Code, Cursor, and goose. Complete.
- Rich provider-specific transcript normalization beyond Claude Code.
watchdaemon with staleness detection.
- Give every run a provider-qualified ID.
- Correlate related runs under a stable logical task ID.
- Capture session-start and session-end lifecycle events without duplicating completed reflection jobs.
- Record timestamps, working tree revisions, changed files, final diffs, evaluation outcomes, wall time, model, provider, and available tokens.
- Provide local
sessionsandsessions showinspection. - Add task-level
progresscomparisons. - Queue reflection outside latency-sensitive hooks with durable job results.
- Add explicit recovery for interrupted/stale worker locks.
- Require an evaluation command and confidence threshold for opt-in automatic promotion.
- Compare equivalent benchmark tasks before and after a promoted rule using success rate, regressions, tokens, and completion time.
- Keep raw transcripts local by default and support configurable redaction before any external reflector receives a trajectory.
Definition of done: a Codex, Claude Code, Cursor, or goose task can be traced from capture to proposal, promotion, and a later measured outcome without manual bookkeeping. Promotion remains gated by a human or evaluation policy.
optimize-> gepa.optimize_anything, token cost in the objective.- Published before/after results.
push/pullan AGENTS.md pack (OCI, KitOps-style).- Community template hub.
- Apache-2.0 (matches AGENTS.md, MCP, goose under the AAIF).
- Stable adapter + reflector interfaces so others extend without forking.
- Semantic versioning. Spec is normative; CLI is one implementation.
- Long-term: propose the spec to the Agentic AI Foundation.