klappy.dev

The Stylebook

Project Maturity & Progressive Governance

Description

Project maturity defines how constraints and policies change as a project matures. Three levels exist: Level 0 (PoC/Exploration) focuses on learning quickly with non-authoritative artifacts; Level 1 (Pilot/Product) delivers value safely with evidence, visual proof, and explicit tradeoffs; Level 2 (Production/Long-Term) sustains trust with measurable outcomes, observability, security, and explicit stop conditions. Rigor increases with maturity. Projects should move up when others depend on them, artifacts persist, decisions become costly to reverse, or trust is implicitly assumed.

Content

Canon v0.1

This governance axis tells agents when to apply rigor, not just what rigor exists.

This page defines how my principles, constraints, and policies change as a project matures.

Not every project needs the same level of rigor on day one.
Applying production-level governance to exploratory work kills learning.
Failing to apply it later destroys trust.

This model exists to activate the right constraints at the right time.


📌 Core Principle

I do not apply all rules equally at all times.

Rigor increases with maturity.
Exploration comes first. Governance comes later.

Every project must explicitly state its current maturity level.


📋 Maturity Levels Overview

I use three maturity levels:

  1. PoC / Exploration
  2. Pilot / Product
  3. Production / Long-Term

These levels are not about importance.
They are about risk, trust, and dependency.


🔬 Level 0PoC / Exploration

Goal: Learn quickly and discard freely.

Characteristics
• Short-lived or experimental
• Ephemeral artifacts
• Low dependency from others
• High uncertainty tolerated

What applies
• Prompt over code
• KISS (loosely)
• DRY (lightly)
• Consistency (local only)
• Evidence of possibility (not correctness)

What does not apply yet
• Formal observability
• Cost optimization
• Trust or authority boundaries
• Production security guarantees
• Long-term reversibility planning

Required labeling

“This is a PoC. Outputs are exploratory and non-authoritative.”

Critical rule

Nothing at this level is considered final or trusted.


🚀 Level 1Pilot / Product

Goal: Deliver real value safely to real users.

Characteristics
• Repeated use
• Growing user expectations
• Shared ownership begins
• Partial persistence

What turns on
• Definition of Done & Evidence Policy
• Visual proof for UI behavior
• Explicit tradeoffs
• Basic observability
• Reversibility for major decisions
• Defined human approval points

New obligation

If users depend on it, it must be verifiable.

Risk posture

Failure is acceptable, but silent failure is not.


✅ Level 2Production / Long-Term

Goal: Sustain trust over time.

Characteristics
• Canonical or authoritative data
• External dependencies
• Organizational or reputational risk
• Long timelines

What becomes mandatory
• Measurable outcomes with metrics
• Continuous feedback loops
• Full observability
• Trust & authority boundaries
• Cost predictability
• Security and privacy defaults
• Explicit stop conditions for autonomy

Critical rule

Nothing enters production without:
• a named owner
• an undo path
• an audit trail

At this level, correctness and trust outweigh speed.


🔗 Relationship to Other Canon Documents

This maturity model modulates the following:
• Constraints
Some constraints are optional at PoC and mandatory later.
• Decision Rules
Rules like KISS and Borrow→Bend→Break→Beget→Build (canon/methods/borrow-bend-break-beget-build.md) apply at all levels, but escalation thresholds change.
• Definition of Done
Evidence requirements increase with maturity.
• Self-Audit Checklist
More items become non-optional as maturity increases.
• Visual Proof Standards
Optional for PoCs, required for Pilot and Production.


🤖 Agent Expectations

Agents and collaborators are expected to:
• explicitly state the project’s maturity level
• apply only the rules required for that level
• refuse to over-govern PoCs
• refuse to under-govern Production systems

If maturity is unclear, the correct action is to ask.


⚠️ Escalation Rules

A project should move up a maturity level when:
• others begin depending on it
• artifacts persist beyond initial intent
• decisions become costly to reverse
• trust is implicitly assumed

A project may move down only with explicit acknowledgment.


🛫 Progressive Governance in Practice — Gate Rigor Scales With Maturity

Passing the gates is the clearance. Delegated authority is exercised, not abdicated.

Clearing the oddkit gated modes — explore → plan → execute → validate → promote — is itself the clearance to ship and deploy at Level 0 and early Level 1 maturity: proof-of-concept, prototype, and the pre-launch launch of something that has no users yet. A flight that clears the gates does not then stop for an additional human-approval halt. The gates already carried the rigor the maturity level requires. This is delegated authority exercised, not abdicated.

The heavier human mechanisms — review-before-publish, irreversibility holds, block-on-public-content — belong to Level 2 / Production: a product with real users, real data, or genuinely irreversible external effects. They must not be reflexively applied to PoCs, prototypes, or the launch of something that has no users yet. Applying production halts to pre-launch work is the "rigor too early kills creativity" failure this document exists to prevent.

Reversibility is the test. If an action is cheaply reversible — revert a deploy of a pre-launch site with no users, roll back a prototype — it flows. The "block only on irreversibility" rule (canon/principles/irreversibility-is-the-real-cost.md) is itself scoped by maturity: what is effectively reversible at pre-launch may be irreversible in production. The same deploy is a shrug at Level 0 and a held breath at Level 2.

Reconciliation

• ARS v1 non-blocking policy (PR #10). Reviewers are advisory, not halts, on reversible pre-launch work. This policy is the maturity axis of that same non-blocking stance: it names when a review may block (Production) and when it may not (PoC / prototype / pre-launch).

• "The captain's authorial voice ships only with review." That rule governs genuinely captain-authored external content in production contexts. It does not govern crew-authored prototype copy at pre-launch. Crew-authored pre-launch copy is not the captain's authorial voice, and no user is reading it yet — it flows under the gates like any other reversible pre-launch artifact.

Captain's Directive — 2026-07-09

"If you follow oddkit modes and gates you can be trusted to just take it live. Stop halting at every opportunity on PoCs, prototypes, and even launches. Production has its own mechanisms."

Otto (the dispatcher) had been over-halting on reversible pre-launch work. This policy corrects that: at Level 0 and early Level 1, passing the gates is the go.


💡 Closing Note

This model exists to protect both:
• exploration, and
• trust.

Rigor too early kills creativity.
Rigor too late kills credibility.

Progressive governance keeps both alive.


Status
• Canon v0.1 — Project Maturity complete
• Canon now supports lifecycle-aware enforcement


What This Unlocks (Important)

With this file added, agents can now:
• ask for or infer maturity
• activate the correct checks automatically
• avoid overbuilding PoCs
• avoid underbuilding production systems

This completes the missing dimension you identified.


Suggested Next Moves (Choose One) 1. Update ODD Manifesto → ODD + Maturity 2. Agent Handoff Instruction (now maturity-aware) 3. MCP schema that exposes maturity as a first-class field 4. Refactor existing canon docs to reference maturity thresholds

Say which you want next, and we’ll continue cleanly.

Markdown · RSS · built from klappy/klappy.dev@b750d7d