codebyplan 1.13.60 → 1.13.62
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/ci.js +518 -0
- package/dist/cli.js +427 -359
- package/package.json +12 -2
- package/templates/agents/cbp-e2e-maestro.md +1 -1
- package/templates/agents/cbp-e2e-playwright.md +1 -1
- package/templates/agents/cbp-e2e-tauri.md +1 -1
- package/templates/agents/cbp-e2e-vscode.md +1 -1
- package/templates/agents/cbp-e2e-xcuitest.md +1 -1
- package/templates/rules/effort-and-ultracode.md +70 -0
- package/templates/rules/model-invocation-convention.md +1 -0
- package/templates/rules/workflow-orchestration.md +59 -0
- package/templates/skills/cbp-build-cc-agent/SKILL.md +1 -0
- package/templates/skills/cbp-build-cc-claude-file/SKILL.md +1 -0
- package/templates/skills/cbp-build-cc-mode/SKILL.md +25 -17
- package/templates/skills/cbp-build-cc-rule/SKILL.md +1 -0
- package/templates/skills/cbp-build-cc-settings/SKILL.md +1 -0
- package/templates/skills/cbp-build-cc-settings/reference/settings-fields.md +1 -1
- package/templates/skills/cbp-build-cc-skill/SKILL.md +2 -1
- package/templates/skills/cbp-build-cc-skill/reference/frontmatter-fields.md +1 -1
- package/templates/skills/cbp-build-cc-skill/scripts/validate-skill.sh +12 -9
- package/templates/skills/cbp-checkpoint-check/SKILL.md +5 -0
- package/templates/skills/cbp-checkpoint-complete/SKILL.md +1 -0
- package/templates/skills/cbp-checkpoint-create/SKILL.md +1 -0
- package/templates/skills/cbp-checkpoint-end/SKILL.md +5 -0
- package/templates/skills/cbp-checkpoint-plan/SKILL.md +5 -0
- package/templates/skills/cbp-checkpoint-start/SKILL.md +1 -0
- package/templates/skills/cbp-checkpoint-update/SKILL.md +2 -1
- package/templates/skills/cbp-clear-continue/SKILL.md +2 -1
- package/templates/skills/cbp-clear-prep/SKILL.md +2 -1
- package/templates/skills/cbp-finalize/SKILL.md +1 -0
- package/templates/skills/cbp-frontend-design/SKILL.md +1 -0
- package/templates/skills/cbp-frontend-ui/SKILL.md +2 -1
- package/templates/skills/cbp-frontend-ux/SKILL.md +2 -1
- package/templates/skills/cbp-git-branch-feat-create/SKILL.md +1 -0
- package/templates/skills/cbp-git-commit/SKILL.md +1 -0
- package/templates/skills/cbp-map-architecture/SKILL.md +5 -0
- package/templates/skills/cbp-merge-main/SKILL.md +1 -0
- package/templates/skills/cbp-refresh-arch-map/SKILL.md +1 -0
- package/templates/skills/cbp-round-build/SKILL.md +5 -0
- package/templates/skills/cbp-round-complete/SKILL.md +1 -0
- package/templates/skills/cbp-round-plan/SKILL.md +5 -0
- package/templates/skills/cbp-session-end/SKILL.md +2 -1
- package/templates/skills/cbp-session-start/SKILL.md +1 -0
- package/templates/skills/cbp-setup-cd/SKILL.md +2 -1
- package/templates/skills/cbp-setup-ci/SKILL.md +2 -1
- package/templates/skills/cbp-setup-e2e/SKILL.md +2 -1
- package/templates/skills/cbp-setup-eslint/SKILL.md +2 -1
- package/templates/skills/cbp-ship/SKILL.md +5 -0
- package/templates/skills/cbp-ship-configure/SKILL.md +2 -1
- package/templates/skills/cbp-ship-main/SKILL.md +1 -0
- package/templates/skills/cbp-standalone-task-check/SKILL.md +1 -0
- package/templates/skills/cbp-standalone-task-complete/SKILL.md +1 -0
- package/templates/skills/cbp-standalone-task-create/SKILL.md +2 -1
- package/templates/skills/cbp-standalone-task-start/SKILL.md +2 -1
- package/templates/skills/cbp-standalone-task-testing/SKILL.md +2 -1
- package/templates/skills/cbp-stripe/SKILL.md +2 -1
- package/templates/skills/cbp-supabase-branch-check/SKILL.md +2 -1
- package/templates/skills/cbp-supabase-migrate/SKILL.md +1 -0
- package/templates/skills/cbp-supabase-setup/SKILL.md +2 -1
- package/templates/skills/cbp-task-create/SKILL.md +2 -1
- package/templates/skills/cbp-task-start/SKILL.md +1 -0
- package/templates/skills/cbp-todo/SKILL.md +2 -1
- package/templates/skills/cbp-verify/SKILL.md +5 -0
- package/templates/skills/supabase/SKILL.md +2 -0
- package/templates/skills/supabase-postgres-best-practices/SKILL.md +2 -0
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: cbp-map-architecture
|
|
3
|
+
model: inherit
|
|
3
4
|
effort: xhigh
|
|
4
5
|
description: Orchestrate architecture map generation for one or all modules. Spawns the cbp-map-architecture agent per module, writes per-module .md files to .claude/architecture/, regenerates INDEX.md and graph.md, and stamps each module via the CLI. Idempotent — safe to re-run.
|
|
5
6
|
argument-hint: '[--module <path>] [--deep <path,...>]'
|
|
@@ -66,6 +67,10 @@ For each module in `targets[]`:
|
|
|
66
67
|
Modules may be spawned concurrently (parallel Task calls) when there are multiple targets
|
|
67
68
|
with no inter-module dependency. The agent is read-only and safe to parallelize.
|
|
68
69
|
|
|
70
|
+
#### Orchestration (optional)
|
|
71
|
+
|
|
72
|
+
Step B's per-module `cbp-map-architecture` fan-out MAY be authored as a `Workflow(...)` script instead of ad-hoc parallel `Task` calls — for deterministic per-module fan-out and schema-validated map outputs. This is opt-in (ultracode session or explicit user request); the parallel `Task` flow above stays the DEFAULT and is unchanged. See `rules/workflow-orchestration.md`.
|
|
73
|
+
|
|
69
74
|
### Step C: Regenerate INDEX.md and graph.md
|
|
70
75
|
|
|
71
76
|
After all per-module map files are written:
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: cbp-refresh-arch-map
|
|
3
|
+
model: inherit
|
|
3
4
|
effort: high
|
|
4
5
|
description: Drift-scoped refresh of the .claude/architecture/ map — re-runs the cbp-map-architecture agent for ONLY the modules whose stamped git SHA has changed, regenerates INDEX.md + graph.md, and re-stamps. Idempotent; no-op when no module has drifted.
|
|
5
6
|
argument-hint: '[--module <path>]'
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: cbp-round-build
|
|
3
3
|
description: Execute the approved plan from /cbp-round-plan — runs per-wave builders, inline testing-qa per wave, and auto-triggers /cbp-verify
|
|
4
4
|
triggers: [cbp-verify]
|
|
5
|
+
model: inherit
|
|
5
6
|
effort: xhigh
|
|
6
7
|
---
|
|
7
8
|
|
|
@@ -197,6 +198,10 @@ Input contracts: `cbp-testing-qa-agent` receives `executor_output`, `testing_pro
|
|
|
197
198
|
|
|
198
199
|
**Independence**: neither agent reads the other's output. Baseline-regression findings surface as a BLOCKING gate at `/cbp-verify` (an explicit accept-or-fix user decision; baselines are NEVER auto-accepted). Per-wave spawns MAY run in parallel with the next wave's builder when dependency order allows. The `cbp-e2e-*` specialists are parallel siblings of `cbp-testing-qa-agent` — they do not share state.
|
|
199
200
|
|
|
201
|
+
#### Orchestration (optional)
|
|
202
|
+
|
|
203
|
+
Under heavy fan-out, Step 5's per-wave builders and their parallel `cbp-testing-qa-agent` + `cbp-e2e-*` siblings MAY be authored as a `Workflow(...)` script instead of ad-hoc `Task`/`Agent` spawning — for deterministic fan-out, wave barriers, and schema-validated outputs. This is opt-in (ultracode session or explicit user request); the spawn flow above stays the DEFAULT and is unchanged. See `rules/workflow-orchestration.md`.
|
|
204
|
+
|
|
200
205
|
### Step 5b: Post-E2E Screenshot Review (cbp-frontend-ui Phase 6.5)
|
|
201
206
|
|
|
202
207
|
Aggregate screenshots across ALL specialists that ran: `screenshots = Object.values(round.context.e2e_outputs ?? {}).flatMap(o => o.screenshots ?? [])`. When the aggregated list is non-empty, invoke the `cbp-frontend-ui` skill with `phase: 'screenshot_review'` (input: `files_changed`, `e2e_screenshots: <aggregated screenshots>`, `context: { checkpoint_goal, round_requirements }`). Under this phase the skill runs only Phase 6.5 (Rendered-Output Visual Review) + 7 + 8 — Phases 1-6 (style) already ran inline at builder Step 3.8 with `phase: 'style_only'`.
|
|
@@ -3,6 +3,7 @@ name: cbp-round-plan
|
|
|
3
3
|
description: Plan a round — round-1 planning AND round-2+ deep-analysis of unapproved work, then spawn cbp-round-planner and auto-trigger /cbp-round-build
|
|
4
4
|
triggers: [cbp-round-build]
|
|
5
5
|
argument-hint: [chk-task-round | task-round | requirements-text] # e.g. `108-1-2`, `45-2`, or free-text
|
|
6
|
+
model: inherit
|
|
6
7
|
effort: xhigh
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -260,6 +261,10 @@ input:
|
|
|
260
261
|
|
|
261
262
|
Wait for planner output. **If the spawn fails, STOP per "Planner Spawn Failure Is A Gate Failure" above** — do not self-certify a plan inline.
|
|
262
263
|
|
|
264
|
+
#### Orchestration (optional)
|
|
265
|
+
|
|
266
|
+
When a plan warrants independent perspectives, Step 7's `cbp-round-planner` spawn MAY be expressed as a `Workflow(...)` script — e.g. a judge-panel of independent plans, scored and synthesized — instead of a single ad-hoc spawn. This is opt-in (ultracode session or explicit user request); the single-spawn flow above stays the DEFAULT and is unchanged. See `rules/workflow-orchestration.md`.
|
|
267
|
+
|
|
263
268
|
### Step 8: Present Plan
|
|
264
269
|
|
|
265
270
|
Present the plan to user:
|
|
@@ -3,7 +3,8 @@ scope: org-shared
|
|
|
3
3
|
name: cbp-setup-cd
|
|
4
4
|
description: Detect configured CD surfaces, write/update .codebyplan/cd.json via `codebyplan cd init`, scaffold publish.yml and release-desktop.yml GitHub Actions workflows, and walk through environment/approval/OIDC setup. Interactive, idempotent.
|
|
5
5
|
argument-hint: "[--force]"
|
|
6
|
-
|
|
6
|
+
model: inherit
|
|
7
|
+
effort: high
|
|
7
8
|
allowed-tools: Read, Write, Edit, Bash(cat *), Bash(jq *), Bash(test *), Bash(ls *), Bash(diff *), Bash(codebyplan cd *), Bash(npx codebyplan cd *), AskUserQuestion
|
|
8
9
|
---
|
|
9
10
|
|
|
@@ -3,7 +3,8 @@ scope: org-shared
|
|
|
3
3
|
name: cbp-setup-ci
|
|
4
4
|
description: Detect CI platforms, write/update .codebyplan/ci.json, scaffold the GitHub Actions CI workflow, and enforce the required CI status check on the main branch. Interactive, idempotent.
|
|
5
5
|
argument-hint: "[--force]"
|
|
6
|
-
|
|
6
|
+
model: inherit
|
|
7
|
+
effort: high
|
|
7
8
|
allowed-tools: Read, Write, Edit, Bash(cat *), Bash(jq *), Bash(test *), Bash(ls *), Bash(codebyplan ci *), Bash(npx codebyplan ci *), Bash(gh api *), Bash(gh auth *), AskUserQuestion
|
|
8
9
|
---
|
|
9
10
|
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
name: cbp-setup-e2e
|
|
3
3
|
description: Detect installed E2E frameworks, ask which to enable, record credentials source (gitignored env-file path + var names only, never secrets), and write/refresh .codebyplan/e2e.json. Interactive, idempotent.
|
|
4
4
|
argument-hint: "[--force]"
|
|
5
|
-
|
|
5
|
+
model: inherit
|
|
6
|
+
effort: high
|
|
6
7
|
allowed-tools: Read, Write, Edit, Bash(cat *), Bash(jq *), Bash(which *), Bash(test *), Bash(mkdir *), Bash(cp *), Bash(echo *), Bash(date *), Bash(mv *), Bash(git check-ignore *), AskUserQuestion, mcp__codebyplan__get_repos
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
name: cbp-setup-eslint
|
|
3
3
|
description: Detect each app's tech stack, resolve matching DB ESLint presets, confirm which to enable per app, run `codebyplan eslint init` to generate eslint.config.mjs, and write/refresh .codebyplan/eslint.json. Interactive, idempotent.
|
|
4
4
|
argument-hint: "[--force]"
|
|
5
|
-
|
|
5
|
+
model: inherit
|
|
6
|
+
effort: high
|
|
6
7
|
allowed-tools: Read, Write, Edit, Bash(cat *), Bash(jq *), Bash(test *), Bash(ls *), Bash(mkdir *), Bash(cp *), Bash(echo *), Bash(mv *), Bash(npx codebyplan eslint *), AskUserQuestion, mcp__codebyplan__get_repos, mcp__codebyplan__get_eslint_presets
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: cbp-ship
|
|
3
3
|
description: Orchestrate runtime deployment for a checkpoint — Vercel web, EAS mobile (Expo Go dev build / TestFlight preview), Tauri desktop, npm package publish, VS Code extension, Railway backend, Supabase migrations. Detects configured surfaces, walks the user through what to deploy, executes per-surface deploy steps, verifies each landed.
|
|
4
|
+
model: inherit
|
|
4
5
|
effort: xhigh
|
|
5
6
|
---
|
|
6
7
|
|
|
@@ -202,6 +203,10 @@ If a surface fails:
|
|
|
202
203
|
|
|
203
204
|
EXCEPTION: `supabase` migration push failure halts the rest. Schema mismatch downstream is worse than partial shipment.
|
|
204
205
|
|
|
206
|
+
#### Orchestration (optional)
|
|
207
|
+
|
|
208
|
+
Step 5's per-surface deploys — the independent tails after the mandatory `supabase`-first step — MAY be authored as a `Workflow(...)` script for deterministic parallel fan-out instead of ad-hoc sequencing. This is opt-in (ultracode session or explicit user request); the sequential flow above (including the `supabase`-first ordering) stays the DEFAULT and is unchanged. See `rules/workflow-orchestration.md`.
|
|
209
|
+
|
|
205
210
|
### Step 6 — Verify each surface landed
|
|
206
211
|
|
|
207
212
|
After each surface deploys, run its verification:
|
|
@@ -3,7 +3,8 @@ name: cbp-ship-configure
|
|
|
3
3
|
description: Configure shipment for one or more surfaces in the current repo — Vercel link, EAS project + eas.json scaffold, Apple credentials probe, npm publish auth check (including `codebyplan` asset-publish automation via the publish-on-main workflow), Railway project link, Supabase access token verify; Supabase GitHub branching integration via /cbp-supabase-setup. Interactive step-by-step; never stores credentials in the repo.
|
|
4
4
|
argument-hint: [--surface=<id>]
|
|
5
5
|
allowed-tools: Read, Write, Edit, Bash(which *), Bash(vercel *), Bash(eas *), Bash(npm *), Bash(railway *), Bash(jq *), Bash(mkdir *), Bash(cp *), Bash(echo *), Skill(cbp-supabase-setup)
|
|
6
|
-
|
|
6
|
+
model: inherit
|
|
7
|
+
effort: high
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# Ship Configure Command
|
|
@@ -3,7 +3,8 @@ scope: repo-only:codebyplan
|
|
|
3
3
|
name: cbp-standalone-task-start
|
|
4
4
|
description: Start a standalone task, load context from DB
|
|
5
5
|
argument-hint: [task] # e.g. `45` (standalone TASK-45)
|
|
6
|
-
|
|
6
|
+
model: inherit
|
|
7
|
+
effort: high
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# Standalone Task Start Command
|
|
@@ -4,7 +4,8 @@ name: cbp-standalone-task-testing
|
|
|
4
4
|
description: Run comprehensive task-level testing after /cbp-standalone-task-check passes
|
|
5
5
|
argument-hint: [task] # e.g. `45` (standalone TASK-45)
|
|
6
6
|
triggers: [cbp-standalone-task-complete]
|
|
7
|
-
|
|
7
|
+
model: inherit
|
|
8
|
+
effort: high
|
|
8
9
|
---
|
|
9
10
|
|
|
10
11
|
# Standalone Task Testing Command
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
scope: org-shared
|
|
3
3
|
name: cbp-stripe
|
|
4
4
|
description: "Stripe integration guidance — load when implementing or reviewing payments, Checkout, subscriptions/billing, webhooks, Connect, Tax, or Treasury. Encodes the API-selection routing table, the no-payment_method_types rule, restricted-key security, and Stripe SDK conventions."
|
|
5
|
-
|
|
5
|
+
model: inherit
|
|
6
|
+
effort: high
|
|
6
7
|
---
|
|
7
8
|
|
|
8
9
|
# Stripe Integration (CBP)
|
|
@@ -3,7 +3,8 @@ name: cbp-supabase-branch-check
|
|
|
3
3
|
description: Gate skill called by /cbp-ship-main (pre-merge) to verify the Supabase preview branch health check is green before allowing a PR to be merged; skips when no DB-path changes are detected.
|
|
4
4
|
argument-hint: "[--mode pre_pr_create|pre_merge] [--target integration|production]"
|
|
5
5
|
allowed-tools: Bash(git *), Bash(gh *), Bash(jq *), Bash(supabase *), Bash(sleep *), Bash(echo *), Read, mcp__supabase__list_branches, mcp__supabase__get_logs
|
|
6
|
-
|
|
6
|
+
model: inherit
|
|
7
|
+
effort: high
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# Supabase Branch Check
|
|
@@ -3,6 +3,7 @@ name: cbp-supabase-migrate
|
|
|
3
3
|
description: Scaffold or adopt a Supabase migration for the current PR branch, apply to the branch's preview DB, run advisor checks, regenerate TypeScript types. Includes a fresh-branch dry-run pre-flight that uses one persistent dry-run ephemeral branch per feature branch.
|
|
4
4
|
argument-hint: "[--new <name> | <path-to-sql>]"
|
|
5
5
|
allowed-tools: Read, Edit, Write, Bash(codebyplan supabase *), Bash(npx codebyplan supabase *), Bash(npx codebyplan checkpoint update *), Bash(npx codebyplan task update *), Bash(git *), Bash(supabase *), Bash(jq *), Bash(date *), Bash(which *), Bash(cp *), Bash(mv *), Bash(test *), Bash(ls *), mcp__supabase__apply_migration, mcp__supabase__list_migrations, mcp__supabase__get_advisors, mcp__supabase__generate_typescript_types, mcp__supabase__reset_branch, mcp__supabase__list_branches, mcp__supabase__create_branch, mcp__supabase__get_cost, mcp__supabase__confirm_cost, mcp__codebyplan__update_checkpoint, mcp__codebyplan__update_task
|
|
6
|
+
model: inherit
|
|
6
7
|
effort: xhigh
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -3,7 +3,8 @@ name: cbp-supabase-setup
|
|
|
3
3
|
description: Enable Supabase GitHub branching integration — GitHub app authorization, required-status-check enforcement on main + integration branch, persistent branch creation, and idempotency marker in .codebyplan/shipment.json.
|
|
4
4
|
argument-hint: "[--force]"
|
|
5
5
|
allowed-tools: Read, Edit, Bash(supabase *), Bash(jq *), Bash(mv *), Bash(date *), Bash(test *), Bash(which *)
|
|
6
|
-
|
|
6
|
+
model: inherit
|
|
7
|
+
effort: high
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# Supabase Branching Setup
|
|
@@ -3,6 +3,7 @@ name: cbp-verify
|
|
|
3
3
|
description: Unified verify stage — deterministic gates, real-execution proof, and a fresh-context diff review at round or task scope. Auto-triggered by cbp-round-build; escalates to task scope on the last clean round.
|
|
4
4
|
argument-hint: [chk-task[-round] | task[-round]]
|
|
5
5
|
triggers: [cbp-round-plan, cbp-round-complete, cbp-finalize]
|
|
6
|
+
model: inherit
|
|
6
7
|
effort: xhigh
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -98,6 +99,10 @@ Triage the returned findings: in-scope mechanical fixes the orchestrator applies
|
|
|
98
99
|
(`Edit`/`Write`); blocking out-of-scope findings → `/cbp-round-plan` fix round. A baseline
|
|
99
100
|
regression is a **blocking user-accept gate** — never auto-accepted.
|
|
100
101
|
|
|
102
|
+
#### Orchestration (optional)
|
|
103
|
+
|
|
104
|
+
When a finding warrants adversarial confirmation, Phase 4's `cbp-verify-reviewer` spawn MAY be expressed as a `Workflow(...)` script — e.g. N independent multi-vote reviewers — instead of a single ad-hoc spawn. This is opt-in (ultracode session or explicit user request); the single-spawn flow above stays the DEFAULT and is unchanged. See `rules/workflow-orchestration.md`.
|
|
105
|
+
|
|
101
106
|
### PHASE 5 — VERDICT + ROUTE (single directive, never an A/B/C menu)
|
|
102
107
|
|
|
103
108
|
Combine Phase 2 + 3 + 4. Route on one directive (`feedback-close-out-routing.md`):
|
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: supabase
|
|
3
3
|
description: "Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS); Supabase CLI or MCP server; schema changes, migrations, security audits, Postgres extensions (pg_graphql, pg_cron, pg_vector)."
|
|
4
|
+
model: inherit
|
|
5
|
+
effort: medium
|
|
4
6
|
metadata:
|
|
5
7
|
author: supabase
|
|
6
8
|
version: "0.1.2"
|
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
name: supabase-postgres-best-practices
|
|
3
3
|
description: Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.
|
|
4
4
|
license: MIT
|
|
5
|
+
model: inherit
|
|
6
|
+
effort: low
|
|
5
7
|
metadata:
|
|
6
8
|
author: supabase
|
|
7
9
|
version: "1.1.1"
|