feat(voyage)!: bulk content rewrite ultra -> voyage/trek prose [skip-docs]
Sed-pipeline (16 patterns, longest-match-first) sweeper residuelle ultra*-treff i prose, command-narrativ, agent-prompts, hook-kommentarer, doc-prosa. Pipeline-utvidelser fra V4-prompten: - BSD-syntax [[:<:]]ultra[[:>:]] istedenfor \bultra\b (BSD sed mangler \b) - 6 compound-patterns for ultraplan/ultraexecute/ultraresearch/ultrabrief/ ultrareview/ultracontinue uten -local-suffiks - ultra*-stats glob -> trek*-stats glob - Linje-eksklusjon redusert til ultra-cc-architect (Q8); session-state- eksklusjonen var over-protektiv - File-eksklusjon utvidet til settings.json, package.json, plugin.json, hele .claude/-treet (gitignored + V5-territorium) Q8-undantak holdt: architecture-discovery.mjs + project-discovery.mjs urort. Filnavn-konvensjon holdt: .session-state.local.json + *.local.* preservert. Manuell narrative-fix: tests/lib/agent-frontmatter.test.mjs linje 10 mangled "/ultra*-local" til "/voyage*-local" (ingen slik kommando finnes); korrigert til "/trek*". Residualer utenfor scope (V5 handterer): package.json + .claude-plugin/ plugin.json (Step 12-14 versjons-bump). .claude/* er gitignored spec-historikk med tilsiktet BEFORE/AFTER-narrativ. Part of voyage-rebrand session 3 (Wave 4 / Step 10). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
parent
ca5a8cec67
commit
14ecda886c
81 changed files with 672 additions and 672 deletions
|
|
@ -11,19 +11,19 @@ allowed-tools: Agent, Read, Glob, Grep, Write, Edit, Bash, AskUserQuestion
|
|||
|
||||
# Ultrareview Local v1.0
|
||||
|
||||
Independent post-hoc review of code delivered by `/ultraexecute-local`
|
||||
Independent post-hoc review of code delivered by `/trekexecute`
|
||||
against the contract in `brief.md`. Produces `review.md` — a structured
|
||||
artifact with severity-tagged findings that `/ultraplan-local --brief
|
||||
artifact with severity-tagged findings that `/trekplan --brief
|
||||
review.md` can consume as plan input (Handover 6).
|
||||
|
||||
Pipeline position:
|
||||
|
||||
```
|
||||
/ultrabrief-local → brief.md
|
||||
/ultraresearch-local → research/*.md
|
||||
/ultraplan-local → plan.md
|
||||
/ultraexecute-local → progress.json (+ commits)
|
||||
/ultrareview-local → review.md (this command)
|
||||
/trekbrief → brief.md
|
||||
/trekresearch → research/*.md
|
||||
/trekplan → plan.md
|
||||
/trekexecute → progress.json (+ commits)
|
||||
/trekreview → review.md (this command)
|
||||
```
|
||||
|
||||
The review is **independent**: each reviewer runs without cross-feeding,
|
||||
|
|
@ -38,15 +38,15 @@ command executes inline.
|
|||
Parse `$ARGUMENTS` via the shared arg-parser:
|
||||
|
||||
```bash
|
||||
node ${CLAUDE_PLUGIN_ROOT}/lib/parsers/arg-parser.mjs --command ultrareview "$@"
|
||||
node ${CLAUDE_PLUGIN_ROOT}/lib/parsers/arg-parser.mjs --command trekreview "$@"
|
||||
```
|
||||
|
||||
The parser recognizes these flags (see `lib/parsers/arg-parser.mjs`
|
||||
FLAG_SCHEMA `ultrareview` entry):
|
||||
FLAG_SCHEMA `trekreview` entry):
|
||||
|
||||
| Flag | Type | Purpose |
|
||||
|------|------|---------|
|
||||
| `--project <dir>` | valued | Required. Path to ultraplan-local project folder containing `brief.md`. |
|
||||
| `--project <dir>` | valued | Required. Path to trekplan project folder containing `brief.md`. |
|
||||
| `--since <ref>` | valued | Optional. Override "before" SHA for the diff. Validated via `git rev-parse --verify`. |
|
||||
| `--quick` | boolean | Skip the brief-conformance pass; run only the code-correctness reviewer; skip the coordinator's reasonableness filter. |
|
||||
| `--validate` | boolean | Schema-only check on existing `{project_dir}/review.md`. No LLM calls. |
|
||||
|
|
@ -57,7 +57,7 @@ Resolution:
|
|||
1. If `--project` is missing, print usage and stop:
|
||||
```
|
||||
Error: --project <dir> is required.
|
||||
Usage: /ultrareview-local --project <dir> [--since <ref>] [--quick] [--validate] [--dry-run]
|
||||
Usage: /trekreview --project <dir> [--since <ref>] [--quick] [--validate] [--dry-run]
|
||||
```
|
||||
2. Trim trailing slash from `{dir}`. Set:
|
||||
- `project_dir = {dir}`
|
||||
|
|
@ -65,7 +65,7 @@ Resolution:
|
|||
- `review_path = {dir}/review.md`
|
||||
3. If `{dir}` does not exist or `{dir}/brief.md` is missing:
|
||||
```
|
||||
Error: project directory not initialized. Run /ultrabrief-local first.
|
||||
Error: project directory not initialized. Run /trekbrief first.
|
||||
Missing: {dir}/brief.md
|
||||
```
|
||||
|
||||
|
|
@ -87,7 +87,7 @@ node ${CLAUDE_PLUGIN_ROOT}/lib/validators/brief-validator.mjs --soft --json "{br
|
|||
|
||||
Read the JSON output. If `valid: false` AND any error has code
|
||||
`BRIEF_MISSING_REQUIRED_FIELD` or `FRONTMATTER_PARSE_ERROR`: stop and
|
||||
ask the user to re-run `/ultrabrief-local`. Other soft errors become
|
||||
ask the user to re-run `/trekbrief`. Other soft errors become
|
||||
warnings in the review's Executive Summary.
|
||||
|
||||
Read the brief frontmatter. Capture for review.md:
|
||||
|
|
@ -299,13 +299,13 @@ After the write succeeds, print:
|
|||
You can:
|
||||
- Read the full review at {review_path}
|
||||
- Feed BLOCKER + MAJOR findings into a follow-up plan:
|
||||
/ultraplan-local --brief {review_path}
|
||||
/trekplan --brief {review_path}
|
||||
- Re-run with `--quick` for a faster correctness-only pass
|
||||
- Re-run with `--since <ref>` to narrow scope
|
||||
```
|
||||
|
||||
Per **Handover 6**, BLOCKER and MAJOR findings are consumed by
|
||||
`/ultraplan-local --brief review.md` to produce a remediation plan. The
|
||||
`/trekplan --brief review.md` to produce a remediation plan. The
|
||||
review's frontmatter `findings:` list and the trailing JSON block are
|
||||
the contract for that handover (see `docs/HANDOVER-CONTRACTS.md`).
|
||||
|
||||
|
|
@ -330,7 +330,7 @@ the contract for that handover (see `docs/HANDOVER-CONTRACTS.md`).
|
|||
- **Refuse-with-suggestion above 100 files / 100K tokens.** Never run
|
||||
blind on a giant diff. Use AskUserQuestion to surface the gate.
|
||||
- **Cost.** Sonnet for all sub-agents (reviewers + coordinator). Opus
|
||||
only runs in the main /ultrareview-local command thread.
|
||||
only runs in the main /trekreview command thread.
|
||||
- **Privacy.** Never log secrets, tokens, or credentials in review.md.
|
||||
Findings citing files with secret-like content must redact the secret
|
||||
in the `detail` field.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue