Maintainer Docs
This is maintainer/contributor documentation, not user-facing. It covers how
to work on akm itself — running it from source, measuring whether changes
actually improve it, and the current state of the curate implementation.
- Local Development — the explicit launcher for each kind of contributor check (live source, built launcher, packed-package acceptance, global checkout install) and the verification commands to run before pushing.
- Release Checklist — local release validation, exact candidate-SHA semantic/Docker/native-scheduler gates, and the evidence links required before publication.
- akm-eval — the evals and benchmarks
that measure whether
akm improveand retrieval changes are actually working. The old in-repo toolkit is retired: see eval.md. - Curate Workmap — the current
akm curatecontract, where its implementation diverges from intended behavior, and the highest-value next fixes.
Architecture and internals
- Architecture documentation — Design, internals, specifications, and contributor reviews.
Testing and contributor plans
- functional contract patterns
- manual testing checklist
- okf v0.2 conformance runbook
- task workflow manual tests
- testing workflow
- 0.10 stabilization plan
- 0.9.15 release plan
- 0.9.2 agent command workflow plan
- 0.9.2 architecture deletion audit
- 0.9.2 reconstruction brief
- 0.9.9 coordinated release
- benchmark harness consolidation
- benchmark harness decisions
- benchmark tuning findings
- guard audit
- index fragment vectors
- index redesign
- local docker execution brief
- port inform capabilities
- search ranking 0.9.14 brief
- p0 invariants
- p1 robots
- p1a with rejection classifier
- p1b model extraction
- p2a task source v4
- p2b input bindings
- p3a plan v5 child freeze
- p3b child executor
- p4 deletions closeout
- subagent extraction design
- website snapshot extraction fix