Skip to content

Commit c209a5b

Browse files
authored
docs: add AI workflow safety overview
Adds a concise README overview of the local deterministic AI workflow safety and evidence chain, with conservative scope boundaries and MCP context reference positioning.
1 parent 49de2ce commit c209a5b

1 file changed

Lines changed: 15 additions & 0 deletions

File tree

README.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -139,6 +139,21 @@ flowchart LR
139139

140140
---
141141

142+
## AI workflow safety evidence
143+
144+
CompText V7 includes a local-only, deterministic evidence chain for AI-assisted repository work. The chain is intended to make review evidence inspectable and artifact-backed without adding external services or runtime orchestration.
145+
146+
- `scripts/safe_pr_gate.py` checks the current branch, working-tree state, changed-file scope, and minimal privacy boundaries.
147+
- `scripts/agent_artifact_bundle.py` records branch, changed files, safe-gate output, validation evidence, and optional MCP context output references.
148+
- `scripts/validate_agent_artifact_bundle.py` validates committed or generated bundle shape and deterministic status fields.
149+
- `scripts/pr_body_from_agent_bundle.py` renders PR body Markdown from bundle data without inventing claims.
150+
- `scripts/ai_workflow_snapshot.py` emits a compact JSON snapshot that combines safe-gate and bundle evidence.
151+
- MCP context output references point to repo-relative artifacts, such as `artifacts/mcp_context_layer_example.json`, rather than embedding full replay payloads in every bundle.
152+
153+
This chain is local-only and uses deterministic JSON/Markdown outputs. It does not call external APIs, contact GitHub APIs, add timestamps or random IDs, execute runtime tools, or perform semantic scoring. It is not an autonomous agent framework, workflow orchestrator, vector memory system, or runtime tool executor.
154+
155+
---
156+
142157
## Minimal deterministic example
143158

144159
```json

0 commit comments

Comments
 (0)