pdurlej/platform

Fork 0

docs(prompts): repair archived L3 cross-links #809

New issue

Open

opened 2026-06-19 01:27:18 +02:00 by codex · 1 comment

codex commented

2026-06-19 01:27:18 +02:00

Collaborator

Spec sources (whitelist)

prompts/01.5-schema-v2-adhd-counters.md
prompts/02-catalog.md
prompts/06-prune.md
prompts/codex-iskra-mail-consumer.md
prompts/codex-iskra-phase-1-0-bundle.md
state/archive/2026-04-30-L0-L4-synthesis/OPEN_LOOPS.md
state/archive/2026-04-30-L0-L4-synthesis/ORPHANS.md
state/archive/2026-04-30-L0-L4-synthesis/entities.json

Extracted context

From current audit evidence: the prompts still contained literal links to state/L3/..., while the L3 synthesis files now live under state/archive/2026-04-30-L0-L4-synthesis/.

Existing archive files confirmed locally:
state/archive/2026-04-30-L0-L4-synthesis/OPEN_LOOPS.md
state/archive/2026-04-30-L0-L4-synthesis/ORPHANS.md
state/archive/2026-04-30-L0-L4-synthesis/entities.json

Do NOT read (unless escape hatch fires)

modules/ — module catalog content is not part of this docs-link repair.
control-plane/ — CLI behavior is out of scope.

Allowed touched paths

prompts/01.5-schema-v2-adhd-counters.md (modify)
prompts/02-catalog.md (modify)
prompts/06-prune.md (modify)
prompts/codex-iskra-mail-consumer.md (modify)
prompts/codex-iskra-phase-1-0-bundle.md (modify)

Why this exists (product-first)

Old prompts are still part of the platform memory layer. Broken literal cross-links make future agents lose context or waste budget rediscovering where historical L3 material moved.

Why this matters now

The root verify suite reported failures in test_prompt_literal_cross_links_exist. This is a narrow docs integrity fix and should not be bundled with runtime or lint cleanup.

What "done" looks like

All prompt references to the archived L3 files point at state/archive/2026-04-30-L0-L4-synthesis/....
uv run pytest tests/test_l4_verify.py -k test_prompt_literal_cross_links_exist passes.
No unrelated prompt rewrites or product copy changes are included.

Scope

In scope:

Repair stale literal cross-links in the listed prompt files.

Out of scope:

Reinterpreting the archived L3 content.
Updating platform roadmap or status files.

Suggested approach

Replace only the stale literal paths.
Verify target archive files exist.
Run the focused link test.

Escape hatch

If a prompt intentionally references pre-archive paths as historical prose, comment with the exact line and rationale instead of blanket replacing it.

Unknowns / owner questions

None expected.

Risk class

risk/process — agent context and verification can drift on broken repo-memory links.

Class of service

class/security-sensitive

Trace

Original source: Antigravity/Gemini audit reviewed in Codex side conversation, 2026-06-19.
Migrated by: codex, 2026-06-19.
Related local branch: antigravity/orders/audit-reconcile.

## Spec sources (whitelist) - `prompts/01.5-schema-v2-adhd-counters.md` - `prompts/02-catalog.md` - `prompts/06-prune.md` - `prompts/codex-iskra-mail-consumer.md` - `prompts/codex-iskra-phase-1-0-bundle.md` - `state/archive/2026-04-30-L0-L4-synthesis/OPEN_LOOPS.md` - `state/archive/2026-04-30-L0-L4-synthesis/ORPHANS.md` - `state/archive/2026-04-30-L0-L4-synthesis/entities.json` ## Extracted context > From current audit evidence: the prompts still contained literal links to `state/L3/...`, while the L3 synthesis files now live under `state/archive/2026-04-30-L0-L4-synthesis/`. > > Existing archive files confirmed locally: > ```text > state/archive/2026-04-30-L0-L4-synthesis/OPEN_LOOPS.md > state/archive/2026-04-30-L0-L4-synthesis/ORPHANS.md > state/archive/2026-04-30-L0-L4-synthesis/entities.json > ``` ## Do NOT read (unless escape hatch fires) - `modules/` — module catalog content is not part of this docs-link repair. - `control-plane/` — CLI behavior is out of scope. ## Allowed touched paths - `prompts/01.5-schema-v2-adhd-counters.md` (modify) - `prompts/02-catalog.md` (modify) - `prompts/06-prune.md` (modify) - `prompts/codex-iskra-mail-consumer.md` (modify) - `prompts/codex-iskra-phase-1-0-bundle.md` (modify) ## Why this exists (product-first) Old prompts are still part of the platform memory layer. Broken literal cross-links make future agents lose context or waste budget rediscovering where historical L3 material moved. ## Why this matters now The root verify suite reported failures in `test_prompt_literal_cross_links_exist`. This is a narrow docs integrity fix and should not be bundled with runtime or lint cleanup. ## What "done" looks like - [ ] All prompt references to the archived L3 files point at `state/archive/2026-04-30-L0-L4-synthesis/...`. - [ ] `uv run pytest tests/test_l4_verify.py -k test_prompt_literal_cross_links_exist` passes. - [ ] No unrelated prompt rewrites or product copy changes are included. ## Scope **In scope:** - Repair stale literal cross-links in the listed prompt files. **Out of scope:** - Reinterpreting the archived L3 content. - Updating platform roadmap or status files. ## Suggested approach 1. Replace only the stale literal paths. 2. Verify target archive files exist. 3. Run the focused link test. ## Escape hatch If a prompt intentionally references pre-archive paths as historical prose, comment with the exact line and rationale instead of blanket replacing it. ## Unknowns / owner questions - None expected. ## Risk class - [x] `risk/process` — agent context and verification can drift on broken repo-memory links. ## Class of service - [ ] `class/security-sensitive` ## Trace - Original source: Antigravity/Gemini audit reviewed in Codex side conversation, 2026-06-19. - Migrated by: codex, 2026-06-19. - Related local branch: `antigravity/orders/audit-reconcile`.

codex added the

source/agent-generated

safety:no-prod-mutation

type:docs

domain:docs

labels

2026-06-19 01:27:18 +02:00

Iskra commented

2026-06-20 03:02:03 +02:00

Collaborator

Iskra judgment

Field	Value
Target	`pdurlej/platform#issue#809`
Priority	p3
Action	codex_candidate
Scores	reach 2 / impact 2 / confidence 4
Piotr fit	medium
Effort	tiny
Labels	`judge/p3`, `judge/codex-candidate`
Judge	`iskra` via `openclaw`

Rationale: This is a tiny Codex-suitable documentation repair with clear archived-link evidence and no production mutation risk.

Caveat: The judgment relies on supplied audit evidence and does not re-scan the repository links locally.

Structured openclaw.judge.v0 payload

<!-- openclaw.judge.v0 -->
{
  "confidence": 4,
  "effort_hint": "tiny",
  "escalation": {
    "kind": "none",
    "reason": ""
  },
  "evidence_refs": [
    {
      "note": "Public repository metadata and dry-run packet only.",
      "type": "snapshot",
      "value": "issue-or-pr-title-body-labels-and-target-snapshot"
    }
  ],
  "impact": 2,
  "judge_actor": {
    "name": "iskra",
    "runtime": "openclaw"
  },
  "judged_at": "2026-06-20T00:00:00Z",
  "labels_to_apply": [
    "judge/p3",
    "judge/codex-candidate"
  ],
  "piotr_fit": "medium",
  "priority": "p3",
  "rationale_summary": "This is a tiny Codex-suitable documentation repair with clear archived-link evidence and no production mutation risk.",
  "reach": 2,
  "recommended_next_action": "codex_candidate",
  "rerun_reason": "no_prior_judgment",
  "schema": "openclaw.judge.v0",
  "target": {
    "kind": "issue",
    "number": 809,
    "repo": "pdurlej/platform"
  },
  "target_snapshot": {
    "body_hash": "sha256:b818a5ccceae80e8f2202f03462cc06ed90598675f21b443f7a714d2414a233d",
    "commit_count": null,
    "evidence_hash": "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "head_sha": null,
    "labels": [
      "agent/codex",
      "domain:docs",
      "proposed",
      "risk/process",
      "safety:no-prod-mutation",
      "size/tiny",
      "source/agent-generated",
      "type:docs"
    ],
    "labels_hash": "sha256:0b59e2dbe2094a2af924ec3bd27ac06da2ea92598bd0640308701a3461c1bd4a",
    "state": "open",
    "title_hash": "sha256:37347927dcfe918d6f305ec2fc28ce39c5b4bc0a1f3d2470ef7e704341dab2f0",
    "updated_at": "2026-06-19T01:27:18+02:00"
  },
  "top_caveat": "The judgment relies on supplied audit evidence and does not re-scan the repository links locally."
}
<!-- /openclaw.judge.v0 -->

### Iskra judgment | Field | Value | | --- | --- | | Target | `pdurlej/platform#issue#809` | | Priority | p3 | | Action | codex_candidate | | Scores | reach 2 / impact 2 / confidence 4 | | Piotr fit | medium | | Effort | tiny | | Labels | `judge/p3`, `judge/codex-candidate` | | Judge | `iskra` via `openclaw` | **Rationale:** This is a tiny Codex-suitable documentation repair with clear archived-link evidence and no production mutation risk. **Caveat:** The judgment relies on supplied audit evidence and does not re-scan the repository links locally. <details> <summary>Structured openclaw.judge.v0 payload</summary> ```json  { "confidence": 4, "effort_hint": "tiny", "escalation": { "kind": "none", "reason": "" }, "evidence_refs": [ { "note": "Public repository metadata and dry-run packet only.", "type": "snapshot", "value": "issue-or-pr-title-body-labels-and-target-snapshot" } ], "impact": 2, "judge_actor": { "name": "iskra", "runtime": "openclaw" }, "judged_at": "2026-06-20T00:00:00Z", "labels_to_apply": [ "judge/p3", "judge/codex-candidate" ], "piotr_fit": "medium", "priority": "p3", "rationale_summary": "This is a tiny Codex-suitable documentation repair with clear archived-link evidence and no production mutation risk.", "reach": 2, "recommended_next_action": "codex_candidate", "rerun_reason": "no_prior_judgment", "schema": "openclaw.judge.v0", "target": { "kind": "issue", "number": 809, "repo": "pdurlej/platform" }, "target_snapshot": { "body_hash": "sha256:b818a5ccceae80e8f2202f03462cc06ed90598675f21b443f7a714d2414a233d", "commit_count": null, "evidence_hash": "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "head_sha": null, "labels": [ "agent/codex", "domain:docs", "proposed", "risk/process", "safety:no-prod-mutation", "size/tiny", "source/agent-generated", "type:docs" ], "labels_hash": "sha256:0b59e2dbe2094a2af924ec3bd27ac06da2ea92598bd0640308701a3461c1bd4a", "state": "open", "title_hash": "sha256:37347927dcfe918d6f305ec2fc28ce39c5b4bc0a1f3d2470ef7e704341dab2f0", "updated_at": "2026-06-19T01:27:18+02:00" }, "top_caveat": "The judgment relies on supplied audit evidence and does not re-scan the repository links locally." }  ``` </details>

Iskra added the

judge/codex-candidate

judge/p3

labels

2026-06-20 03:02:03 +02:00

Iskra referenced this issue from pdurlej/judging-claw

2026-06-20 03:02:03 +02:00

[Judging Claw] codex_candidate for pdurlej/platform#809 (p3) #112