spec v2: apply codex critique, add codex-reviewer subagent

- separate DB models from API types (no more "one struct rules all")
- drop utoipa, drop channel membership, drop model from users
- add seq ordering, soft delete, hashed tokens, same-channel reply constraint
- WS auth via first message instead of query param
- reorder stories to vertical slice (conversation model first, deploy early)
- add codex-reviewer subagent for parallel GPT-5.4 reviews
- update critic + ax skills to use codex-reviewer

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-03-29 18:40:52 +02:00
parent 1bbe852fd2
commit 160bd603e7
5 changed files with 349 additions and 0 deletions

View File

@@ -106,6 +106,22 @@ For each:
- Exact implementation (file + content)
```
## Parallel Codex Review
On every AX audit invocation, **immediately** spawn the `codex-reviewer` subagent in the background before starting your own audit:
```
Agent(subagent_type="codex-reviewer", run_in_background=true,
prompt="AX audit: $ARGUMENTS. Read CLAUDE.md, .claude/ directory, and config files. Find: missing docs, unclear commands, split-brain config, stale references. File paths and exact fixes.")
```
Continue your own audit without waiting. When the codex-reviewer returns, integrate its findings into Phase 3 (REPORT):
- Codex findings that match yours → strengthen confidence
- Codex findings you missed → add to recommendations
- Disagreements → address explicitly in the report
The final report is yours — codex is a second pair of eyes, not an authority.
## Constraints
- This skill is **read-only** — it never modifies files, only reports

View File

@@ -56,6 +56,22 @@ Optional prose narrative follows after a blank line.
- For research claims, demand evidence or explicit acknowledgment of speculation.
- For vibecoded implementations, focus on correctness and security over style.
## Parallel Codex Review
On every critic invocation, **immediately** spawn the `codex-reviewer` subagent in the background before starting your own analysis:
```
Agent(subagent_type="codex-reviewer", run_in_background=true,
prompt="Critique: $ARGUMENTS. Read all relevant files. What will break? What's missing? What's over-engineered?")
```
Continue your own critique without waiting. When the codex-reviewer returns, integrate its findings into your verdict:
- Codex issues you missed → add to `breakpoints`
- Codex agrees with you → note in `survives` as independent confirmation
- Codex disagrees → address in prose narrative
The final verdict is yours — codex is a second opinion, not an override.
## Research-specific checks
When critiquing RL transfer hypotheses or experimental design: