Skip to content

docs(v1-readiness): 📝 add v1.0 release criteria and dogfooding tracker#106

Merged
justapithecus merged 3 commits intomainfrom
andrew/docs/v1-readiness/criteria
Feb 7, 2026
Merged

docs(v1-readiness): 📝 add v1.0 release criteria and dogfooding tracker#106
justapithecus merged 3 commits intomainfrom
andrew/docs/v1-readiness/criteria

Conversation

@justapithecus
Copy link
Owner

Summary

Adds a normative v1.0 readiness document (docs/V1_READINESS.md) defining 30 verifiable criteria across 9 categories that must all pass before v1.0 can be tagged. Stability is proven by usage and time, not design review.

Highlights

  • Gate rule: all criteria must pass with recorded evidence; none may be waived
  • 30 criteria across: API freeze, manifest freeze, Dataset dogfooding, Volume dogfooding, error paths, S3 verification, known limitations, documentation completeness, data correctness
  • Dogfooding registry with quarry pre-populated and a commented template for future projects
  • Evidence blocks on every criterion: date, observer, project, summary, issue link
  • Out-of-scope section explicitly excludes CAS, Zarr, perf, new codecs, new adapters
  • ARCH_INDEX.md updated with reference to the new document

Test plan

  • All 30 criteria present with evidence blocks
  • ARCH_INDEX.md references V1_READINESS.md
  • Only two files changed (docs/V1_READINESS.md created, docs/ARCH_INDEX.md edited)
  • Review criteria categories for completeness

🤖 Generated with Claude Code

justapithecus and others added 3 commits February 7, 2026 14:08
Normative readiness document defining 30 verifiable criteria across 9
categories that must all pass before v1.0 can be tagged. Includes
dogfooding registry with per-project evidence tracking and a quarry
template pre-populated.

- Gate rule: all criteria must pass, none waived
- Criteria: API freeze, manifest freeze, Dataset dogfooding, Volume
  dogfooding, error paths, S3 verification, known limitations,
  documentation completeness, data correctness
- Each criterion has an evidence block for date/observer/issue tracking
- Out-of-scope section explicitly excludes CAS, Zarr, perf, new adapters
- ARCH_INDEX.md updated with reference to new document

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Private downstream projects use redacted aliases and backend-agnostic
usage descriptions. Evidence blocks and issue references must not leak
private context — private tracker issues referenced as (private).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…leaks

Evidence and usage profiles must describe Lode-level behavior only,
not the consumer's architecture or data model. Prevents private project
implementation details from being inferred through dogfooding entries.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@justapithecus justapithecus merged commit bb612eb into main Feb 7, 2026
5 checks passed
@justapithecus justapithecus deleted the andrew/docs/v1-readiness/criteria branch February 7, 2026 19:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant