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.
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
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 compactCPK-*and compact execution trio.R2: change Truth, ADRs, external contracts, persistent data semantics, security, privacy, permissions, or irreversible operations. Create a completeCPK-*.
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.
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.
P2T2C_EN/: English release rootP2T2C_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/**.
make check
make checksums
bash scripts/release_smoke_test.shmake check validates both release roots and their stable path, manifest, version, and script parity.
Choose one release root:
cd P2T2C_EN
make p2t2c-install-dry-run TARGET=/path/to/project
make p2t2c-install TARGET=/path/to/projectcd P2T2C_CN
make p2t2c-install-dry-run TARGET=/path/to/project
make p2t2c-install TARGET=/path/to/projectP2T2C is released under the MIT License. See LICENSE.