Skip to content

Repository files navigation

P2T2C Release Selector

P2T2C means Proposal-to-Truth-to-Code. It is an AI-first engineering workflow that keeps business Truth explicit while routing work by risk instead of requiring the same documentation ceremony for every change.

Workflow

flowchart TB
  S1["Stage 1: Intent Admission<br/>clarify intent, conflicts, and impact"]
  S2["Stage 2: Risk Routing and Truth<br/>R0 direct · R1 compact CPK · R2 decision CPK"]
  S3["Stage 3: Work Batch Execution<br/>multiple related tasks accepted as one batch"]
  S4["Stage 4: Verification and Repair<br/>build · test · lint · typecheck · governance"]
  S5["Stage 5: Drift and Closure<br/>Gate B for Truth Drift · CR-* for every completion"]

  S1 --> S2 --> S3 --> S4 --> S5
Loading

Risk levels:

  • R0: refactoring, tests, docs, CI changes, or restoring behavior already defined by Truth. No CPK or execution docs.
  • R1: implement behavior already covered by Truth. Create a compact CPK-* and compact execution trio.
  • R2: change Truth, ADRs, external contracts, persistent data semantics, security, privacy, permissions, or irreversible operations. Create a complete CPK-*.

Gate A controls only undecided R2 semantics. Gate B controls Truth Drift. Every completed R0/R1/R2 change creates a CR-* with actual verification evidence and remaining risks.

Execution Method Layer

P2T2C remains the control layer for risk, Truth, gates, and closure. Release 0.13.0 adds a native method layer for design refinement, risk-aware TDD, root-cause debugging, independent review, and workspace isolation. These methods never replace Truth or add an external plugin dependency.

New installs enable the balanced profile by default. Existing projects stay in advisory compatibility mode until they add a methodology section to .p2t2c/project_config.yaml.

Release Roots

  • P2T2C_EN/: English release root
  • P2T2C_CN/: Chinese release root

The repository root is only a selector and aggregate check surface. Current workflow Truth lives inside each selected release root under docs/sot/**.

Checks

make check
make checksums
bash scripts/release_smoke_test.sh

make check validates both release roots and their stable path, manifest, version, and script parity.

Install

Choose one release root:

cd P2T2C_EN
make p2t2c-install-dry-run TARGET=/path/to/project
make p2t2c-install TARGET=/path/to/project
cd P2T2C_CN
make p2t2c-install-dry-run TARGET=/path/to/project
make p2t2c-install TARGET=/path/to/project

License

P2T2C is released under the MIT License. See LICENSE.

About

Proposal-to-Truth-to-Code AI coding workflow

Topics

Resources

Contributing

Security policy

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages