Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs_build/dev/ProjectInstructions/README.txt
Original file line number Diff line number Diff line change
Expand Up @@ -46,3 +46,4 @@ Addendum index:
- Test Structure Standardization: project-instructions/addendums/test-structure-standardization.md
- Legacy Migration Policy: project-instructions/addendums/legacy-migration-policy.md
- Assistant Execution Modes: project-instructions/addendums/assistant-execution-modes.md
- Codex Artifact and Reporting Standard: project-instructions/addendums/codex-artifact-and-reporting-standard.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# Codex Artifact and Reporting Standard

## Purpose

Standardize Codex deliverables, completion reporting, and artifact generation.

## ZIP Artifact Requirement

Every Codex task must produce a ZIP artifact.

Applies to:
- Success
- Failure
- Stop Gate
- Partial Completion
- Review Deliverables
- Governance Deliverables

Minimum ZIP contents:
- summary.md

Optional:
- changed-files.txt
- findings.md
- validation.txt
- generated artifacts

## Completion Reporting

Codex responses must include:
- ZIP filename
- ZIP location
- PR number(s)
- Merge commit(s)
- Validation results

## Code Change Reporting

When a ZIP is uploaded, report executable code changes only.

Report format:

```text
{relative path} — {added|updated|deleted}
```

Examples:

```text
toolbox/text-to-speech/index.html — updated
assets/toolbox/text-to-speech/js/index.js — added
tests/toolbox/text-to-speech/functional.spec.mjs — updated
```

Do not report:
- markdown
- documentation
- reports
- notes
- README updates

unless explicitly requested.

## No ZIP Means Incomplete

A task is not considered complete until the ZIP artifact is generated and reported.
Loading