The canonical core is the authority of Project Forge. Every decision the system makes — about scope, criteria, artifact grammar, or working procedure — traces back to one of four canonical files. These files do not hold live case state. They define the frame, the rules, and the allowed surfaces. Nothing below them may redefine them. Nothing outside them may override them without explicit delegation. If you need to know what the system is allowed to do, what counts as ready, or what an artifact is permitted to contain, the answer is in the canonicals.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/xxyoudeadpunkxx/gpt-pf-chat-gpt-project-forge/llms.txt
Use this file to discover all available pages before exploring further.
Read Order vs. Precedence Order
These are two distinct concepts that are easy to confuse. Understanding the difference is essential for working with the canonical core correctly. Read order is the practical order in which you rebuild the system in a new session. It is optimized for comprehension — frame first, then criteria, then artifact grammar, then procedure. This is the order you give to an AI or follow yourself when entering the system fresh.03_ARTIFACTS.md is read before 02_PROTOCOL.md for comprehension purposes, but 02_PROTOCOL.md outranks 03_ARTIFACTS.md in authority.
Canonical File Reference
00_SCOPE.md — System Frame and Identity
00_SCOPE.md — System Frame and Identity
Purpose
Define the identity, scope, non-scope, target, and final output of Project Forge.Authority
Highest on system frame. No lower file may redefine this file on any point it closes.Read Order
Read first.Contains
- System identity
- System scope
- System non-scope
- Target of the system
- Final output of the system
- General use perimeter
Does Not Contain
- Classification rules
- Residence rules
- Procedural flow
- Artifact grammar
- Readiness logic
- Source validation rules
- Runtime override rules
- Live case state
- Handoff content
- Domain examples
Key Rules
Identity Project Forge is a permanent preparation system for opening target projects in ChatGPT. Project Forge does not execute the target project. Project Forge prepares the target project.Scope Project Forge may: define what project is being prepared; define what the prepared project must receive to start correctly; define the frame that the core protocol must obey; externalize case state into controlled artifacts.Non-Scope Project Forge must not become: the live target project; a case archive; a long-term mixed notebook; a memory substitute; a raw source dump; a domain-shaped framework pretending to be general.Target The system targets projects that must start from explicit structure instead of reconstruction from chat.Final Output The system produces: a stable canonical core; external artifacts for target-project opening; external artifacts for case state transfer when required.Frame Rule This file closes the frame of the system. Nothing below this file may redefine system scope, non-scope, target, or final output.Success Condition Project Forge succeeds only if: the system remains domain-agnostic; the core remains free of live case state; the target project can open from explicit materials; ambiguity is reduced without being hidden.Final Rule Project Forge exists to prepare projects without becoming one.01_RULES.md — Criteria and Authority
01_RULES.md — Criteria and Authority
03_ARTIFACTS.md — Artifact Grammar and Classes
03_ARTIFACTS.md — Artifact Grammar and Classes
Purpose
Define the grammar of allowed external artifacts.Authority
Highest on artifact surface and artifact grammar. This file may define artifact-local authority. This file may not redefine canonical truth, scope, criteria, or procedure.Read Order
Read after01_RULES.md and before 02_PROTOCOL.md.Contains
- Allowed artifact classes
- System artifact baseline
- Local artifact authority
- Artifact surface
- Artifact schema
- Write triggers
- Read triggers
- Freshness rules
- Artifact-specific promotion conditions
- Custom artifact requirements
- Artifact read order
Does Not Contain
- Live artifact instances
- Live SSOT content
- Live handoff content
- Live target brief content
- Case state
- Canonical criteria
- Procedural sequencing
Artifact Read Order
Baseline Artifact Classes
TARGET_PROJECT_BRIEF_ARTIFACT| Field | Value |
|---|---|
| Purpose | Transmit the minimum project-specific operational brief of the target project |
| Authority | Local to the target project; may not redefine the frame of Project Forge |
| Surface | Project-opening artifact |
| Write Trigger | When documentary readiness requires a target-project brief |
| Read Trigger | At target-project opening |
| Freshness Rule | Update only when the target-project brief changes |
| Promotion | Never promotable to system canonical |
objective, scope_in, scope_out, required_outputs, project_specific_constraintsINITIAL_SSOT_ARTIFACT| Field | Value |
|---|---|
| Purpose | Freeze the initial official basis of the target project |
| Authority | Local to the target project; initial reference authority for the starting basis |
| Surface | Official-basis artifact |
| Write Trigger | When an initial official basis exists and must be frozen |
| Read Trigger | Immediately after TARGET_PROJECT_BRIEF_ARTIFACT |
| Freshness Rule | Update only when the initial official basis changes |
| Promotion | May be updated only from material already validated under 01_RULES.md |
official_materials, approved_sources, base_constraints, version_or_dateHANDOFF_ARTIFACT| Field | Value |
|---|---|
| Purpose | Transfer operational continuity across runs without redefining frame or SSOT |
| Authority | Local and temporary only; not normative |
| Surface | Operational-continuity artifact |
| Write Trigger | Only when 02_PROTOCOL.md closes HANDOFF_REQUIRED |
| Read Trigger | When reopening the immediately following run |
| Freshness Rule | Valid only for the immediately following run unless explicitly renewed |
| Promotion | Never promotable to canonical or SSOT |
current_state, recent_tests, open_points, next_moveSOURCE_OR_MATERIAL_TRANSFER_ARTIFACT| Field | Value |
|---|---|
| Purpose | Transfer candidate materials or sources without promoting them to stable basis |
| Authority | Local and subordinate only; not normative until validated |
| Surface | Material-transfer artifact |
| Write Trigger | When materials must pass to the target project without immediate promotion |
| Read Trigger | After INITIAL_SSOT_ARTIFACT and before HANDOFF_ARTIFACT, if present |
| Freshness Rule | Update on each materially new transfer set |
| Promotion | Promotable only after validation under 01_RULES.md |
candidate_materials, source_type, validation_state, attach_or_review_flagCustom Artifact Rule
A custom artifact is valid only if it explicitly declares all eight of the following fields:02_PROTOCOL.md — Working Procedure and States
02_PROTOCOL.md — Working Procedure and States
Purpose
Define the minimum working procedure of Project Forge.Authority
Highest on procedure. This file applies criteria already closed above. This file may not redefine criteria, frame, or artifact grammar.Read Order
Read after01_RULES.md. Read after 03_ARTIFACTS.md when artifact grammar is required for the current move.Contains
- Intake
- Target closure
- Output closure
- Stability classification
- Residence assignment
- Source validation application
- Promotion flow
- Readiness gate application
- Handoff need application
- Runtime override handling
DO_NOT_STOREsink handling- Measurable readiness application
- Peer conflict handling
- State definitions
- State outputs
- Stop conditions
Does Not Contain
- New criteria
- New authority hierarchy
- Artifact grammar
- Live case state
- Live handoff content
- Scope redefinition
State Definitions
| State | Meaning |
|---|---|
READY | All required gate conditions for the current opening decision are satisfied |
NOT_READY | Required material is still missing or weak, but the frame and procedure remain coherent |
BLOCKED | A structural condition is missing, invalid, or unavailable — the flow cannot continue safely |
CONFLICT | Two or more surfaces produce incompatible claims that cannot be closed at the current authority level |
Output Minimums Per State
READYreadiness_basisauthorized_next_moveartifacts_to_readartifacts_to_emit
NOT_READYmissing_itemsweak_itemsblocking_or_non_blockingminimum_next_move
BLOCKEDblocking_causegoverning_ownerminimum_unblock_move
CONFLICTconflicting_sourcesresolution_rule_appliedsuspended_pointminimum_unblock_movepeer_authority_status