spec: builder-check brief for plans, caps and packs
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 file changed,
+30
−0
docs/superpowers/specs/CODEX-REVIEW-BRIEF-PLANS-CAPS.md+30 −0
CI cancelled — superseded by a newer push — run details
CI log
=== gate === cd launchctx && go vet ./... && go test ./... -count=1 ok amadan.net/carlos/platform.git/launchctx 0.012s ? amadan.net/carlos/platform.git/launchctx/controlname [no test files] ? amadan.net/carlos/platform.git/launchctx/wireid [no test files] go vet ./... gofmt -l .: clean go test ./... -count=1 -timeout 30m ok github.com/carlosframework/platform 332.190s ? github.com/carlosframework/platform/cmd/changelog [no test files] ok github.com/carlosframework/platform/cmd/console 2.988s ok github.com/carlosframework/platform/cmd/moveprobe 93.306s ok github.com/carlosframework/platform/cmd/zddprobe 0.708s ok github.com/carlosframework/platform/internal/activator 251.739s ok github.com/carlosframework/platform/internal/agentsock 0.017s ok github.com/carlosframework/platform/internal/alerting 0.004s ok github.com/carlosframework/platform/internal/analytics 0.028s ok github.com/carlosframework/platform/internal/appconfig 2.563s ok github.com/carlosframework/platform/internal/apperr 0.077s ok github.com/carlosframework/platform/internal/applog 0.135s ok github.com/carlosframework/platform/internal/awsinv 0.004s ok github.com/carlosframework/platform/internal/boxchoice 0.004s ok github.com/carlosframework/platform/internal/boxid 0.745s ? github.com/carlosframework/platform/internal/boxid/boxidtest [no test files] ? github.com/carlosframework/platform/internal/boxid/internal/signtest [no test files] ok github.com/carlosframework/platform/internal/boxvolumes 0.009s ok github.com/carlosframework/platform/internal/caps 0.014s ok github.com/carlosframework/platform/internal/certwarm 0.003s ok github.com/carlosframework/platform/internal/cgroup 0.699s ok github.com/carlosframework/platform/internal/changelog 0.338s ok github.com/carlosframework/platform/internal/claimactivation 0.810s ok github.com/carlosframework/platform/internal/clamd 0.054s ? github.com/carlosframework/platform/internal/cliflag [no test files] amadan: job cancelled — a newer push superseded it
diff --git a/docs/superpowers/specs/CODEX-REVIEW-BRIEF-PLANS-CAPS.md b/docs/superpowers/specs/CODEX-REVIEW-BRIEF-PLANS-CAPS.md| new file mode 100644 |
| index 000000000..3982379fd |
| --- /dev/null |
| +++ b/docs/superpowers/specs/CODEX-REVIEW-BRIEF-PLANS-CAPS.md |
| @@ -0,0 +1,30 @@ |
| +# Builder check brief: plans, caps and packs |
| + |
| +You are a talented senior Go engineer on the carlos platform. You've been |
| +handed `docs/superpowers/specs/2026-10-20-plans-caps-packs-design.md` (at |
| +the commit you are reviewing) and asked to put together an implementation |
| +plan for what it describes. You will not be able to talk to the person who |
| +wrote it. |
| + |
| +Read the design. You may read the code on `origin/main` (the worktree is |
| +main plus this spec) to check what it cites, and the unmerged branch |
| +`origin/feat/carloku-backend-integration-20261003` via `git show` for the |
| +harvest list. Do not build, test or modify anything. |
| + |
| +Report only the questions you'd still need answered before you could plan |
| +this well: places where you'd have to guess and a wrong guess would matter. |
| +For each, give the question and why the answer changes the plan. Rank them |
| +by importance. |
| + |
| +Also report, separately and briefly, any code citation in the design that |
| +is wrong (file or line does not say what the design claims) where the |
| +error would mislead a builder. |
| + |
| +Section 3 lists decisions already made by the product owner. Do not argue |
| +with them; report only places where the design fails to honour them or |
| +where they conflict with each other or with the code. |
| + |
| +Skip anything the document explicitly leaves to the builder (section 13), |
| +anything you could reasonably decide yourself, and wording nitpicks. |
| + |
| +If nothing important is left, say "nothing important left". |