plan-ceo-review
Skill2 starsChanged 25 days agoMITView on GitHub
Product-strategist mode review on a draft plan. 4 scope-modes (EXPAND / SELECTIVE / HOLD / REDUCE) chosen explicitly upfront and committed-to throughout. Catches scope drift, surfaces 10x opportunities, hardens rigor against silent failures. Includes Landscape Check (search-before-building) + Taste Calibration (codebase reference patterns) + 5 Prime Directives.
49 other projects use a version of this, 7 of them edited.
Adopted by
Most recently taken up by
- timurgaleev/vibestacktheir own version, first seen Nov 8, 2026
- trungtm78/ClaudeSkillstheir own version, first seen Oct 25, 2026
- Marco-Satis/claude-setuptheir own version, first seen Oct 20, 2026
- GusevV1987/ai-workspace-kittheir own version, first seen Oct 15, 2026
- Yesterday-AI/ytstacktheir own version, first seen Oct 13, 2026
- matthewharrilal/claude-skillstheir own version, first seen Oct 13, 2026
Used with
Projects with it also use plan-tune, ios-clean and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
ShreyRaviSkillplan-tune
Self-tuning question sensitivity + developer psychographic for gstack (v1: observational). Review which AskUserQuestion prompts fire across gstack skills, set per-question preferences (never-ask / always-ask / ask-only-for-one-way), inspect the dual-track profile (what you declared vs what your behavior suggests), and enable/disable question tuning. Conversational interface — no CLI syntax required.
Also in 9 projects that use this
Saqlain-811Skillios-clean
Remove the DebugBridge SPM package and all #if DEBUG wiring from an iOS app. (gstack)
Also in 5 projects that use this
Saqlain-811Skillios-fix
Autonomous iOS bug fixer. (gstack)
Also in 5 projects that use this
ShreyRaviSkilllanding-report
Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)
Also in 8 projects that use this
timurgaleevSkilldocument-generate
Generate missing docs for a feature, module or project as tutorials, how-tos, reference and explanation.
Also in 7 projects that use this
seek888Skillpair-agent
Pair a remote AI agent with your browser. One command generates a setup key and prints instructions the other agent can follow to connect. Works with OpenClaw, Hermes, Codex, Cursor, or any agent that can make HTTP requests. The remote agent gets its own tab with scoped access (read+write by default, admin on request). Use when asked to "pair agent", "connect agent", "share browser", "remote browser", "let another agent use my browser", or "give browser access". (gstack) Voice triggers (speech-to-text aliases): "pair agent", "connect agent", "share my browser", "remote browser access".
Also in 10 projects that use this
- +1 more from Saqlain-811
- +2 more from ShreyRavi
Other versions49 projects use a version of this.
Word for word · 0
None found.
Edited · 7
- aryaniyaps/dot-ai★ 133% same
- nileshteji/skills★ 129% same
- Biznomad/claude-skills★ 033% same
- chriswestt/claude-skills★ 033% same
- greenharborlabs/claude-skills★ 050% same
- ignavm1/claude-skills★ 033% same
- Wyx1105170322/claude-skills★ 033% same
Wrote their own version · 42
- garrytan/gstack★ 141ksame name
- DenchHQ/DenchClaw★ 1.7ksame name
- DenchHQ/ironclaw★ 1.7ksame name
- mr-daedalium/ostack-saas★ 108same name
- no-session/pstack★ 96same name
- lucas-flatwhite/gstack-ko★ 45same name
- AICreator-Wind/gstack-openclaw-skills★ 44same name
- WillNigri/Agentic-Tool-Optimization★ 34same name
- CarbeneAI/Forge★ 9same name
- Samin12/skills★ 8same name
32 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository57 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- llms.txtllms.txt
- advisorSkill
- agent-dispatchSkill
- arenaSkill
- audit-pypi-model-packageSkill
- branching-workflowSkill
- code-reviewSkill
- criticSkill
- cron-child-oauth-auditSkill
- daily-forestSkill
- deep-researchSkill
- diagnose-cron-timeoutSkill
- dreamingSkill
- eod-summarySkill
- filingSkill
- forest-synthesisSkill
- goalsSkill
- graph-hygieneSkill
- ideaSkill
- inline-tagsSkill
- intel-analyzerSkill
- longformSkill
- loop-experimentSkill
- loop-librarySkill
- meta-memory-reviewSkill
- office-hoursSkill
- open-loopsSkill
- plan-design-reviewSkill
- prdSkill
- progressive-disclosureSkill
- reality-feedback-createSkill
- reality-review-weeklySkill
- recallSkill
- reconcile-extractionSkill
- redactSkill
- repo-auditSkill
- research-digestSkill
- review-gateSkill
- run-long-job-detachedSkill
- saveSkill
- scopeSkill
- self-auditSkill
- shadow-test-local-classifierSkill
- signal-scorerSkill
- skill-auditSkill
- skill-chainingSkill
- spawn-agent-in-tenantSkill
- spawn-tenantSkill
- split-log-rows-by-session-kindSkill
- subagent-delegationSkill
- telegram-dump-routerSkill
- telegram-reply-toolSkill
- verify-stackSkill
- wave-planSkill
- weekly-retroSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
19 rules. 0 are common, 14 are distinctive, and 5 are very specific to this project.
0
Common
Most of the 41 edited versions we read keep these.
14
Distinctive
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 22
When the operator says "is this ambitious enough" or "rethink this"
- Very specific: line 28
Read §1 of knowledge/gstack-cross-cutting-patterns.md (the decision-brief question format).
- Distinctive: line 34
Before ANY review, ask which mode this is.
- Distinctive: line 36
Ask via a structured user question:
- Distinctive: line 51
Do NOT silently reduce OR expand.
- Distinctive: line 60
Read the plan/draft in full
- Distinctive: line 61
Read CLAUDE.md for project conventions
- Very specific: line 62
Read the relevant memory/projects/<slug>.md if scoped
- Distinctive: line 77
Search-before-building gate.
- Distinctive: line 83
If something obvious already exists and we're proposing to rebuild it, surface that finding as the FIRST decision.
- Very specific: line 93
Every error has a name: Don't say "handle errors." Name the specific exception class, what triggers it, what catches it, what the user …
- Distinctive: line 95
Data flows have shadow paths: Every data flow has 4 paths: happy / null input / empty input / upstream error.
- Distinctive: line 99
Interactions have edge cases: Every user-visible action has: double-click / navigate-away-mid-action / slow connection / stale state / back …
- Distinctive: line 107
When evaluating "approach A (full, ~150 LOC) vs approach B (90%, ~80 LOC)":
- Distinctive: line 111
DEFAULT: prefer the full A unless REDUCTION mode is explicitly selected
- Very specific: line 127
Write the proposed plan diff to the original artifact OR outputs/raw/plan-reviews/YYYY-MM-DD-<slug>-ceo-review.md.
- Very specific: line 135
If the review surfaced a non-obvious pattern (e.g.
- Distinctive: line 139
After display, recommend the next review:
- Distinctive: line 163
Every scope change is an explicit user question.
“Common” is measured: kept by at least 6 in 10 of the 41 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Plan CEO Review. Product-Strategist Mode
Why this exists
A plan can be technically rigorous AND strategically wrong. Engineering review catches "will this work?" CEO review catches "is this the 10-star product?" / "is this the right thing to build?" / "did we silently scope this down because shipping is cheaper than thinking?"
Complements decision-council (anonymized peer review). that one finds blind spots in reasoning. This one challenges scope + ambition + strategic framing.
When to fire
- Pre-build planning when scope is fuzzy or feels small
- Mid-build when shipping the smaller version became the default ("let's punt the hard part")
- Pre-ship review on a proposal, deck, or strategy artifact
- When the operator says "is this ambitious enough" or "rethink this"
Skip for tactical execution (bug fixes, scheduler adjustments, small refactors). The CEO doesn't review your typo fixes.
Pre-reading (consult once before Step 0)
Read §1 of knowledge/gstack-cross-cutting-patterns.md (the decision-brief question format). The 4-mode framework requires structured questions when surfacing scope changes. don't freestyle.
Procedure
Step 0. Mode selection (CRITICAL, commit-to-it)
Before ANY review, ask which mode this is. The mode controls posture for the entire review. Once selected, do not silently drift.
Ask via a structured user question:
A) SCOPE EXPANSION. "We're building a cathedral. Envision the platonic ideal. Push scope UP. Ask 'what would make this 10x better for 2x the effort?'"
- Posture: dreaming-with-rigor. You have permission to recommend enthusiastically.
- Each expansion is the user's opt-in via an explicit question. Never silently add scope.
- Question to ask repeatedly: "what would make this 10x better for 2x the effort?"
- Anti-drift: if EXPANSION is selected and you later find yourself arguing for less work, that's drift. stop and check.
B) SELECTIVE EXPANSION. "Hold current scope as baseline + cherry-pick expansions individually."
- Posture: rigorous reviewer with taste.
- Each expansion presented as a separate question. Accepted ones join scope. Rejected ones explicitly go to "NOT in scope."
- Neutral recommendation posture. present effort + risk, let the user decide.
C) HOLD SCOPE. "Scope is locked. Make it bulletproof."
- Posture: rigorous reviewer. Catch every failure mode, test every edge case.
- Do NOT silently reduce OR expand.
- Output is hardening + observability + edge cases, not new features.
D) SCOPE REDUCTION. "Find the minimum viable version that achieves the core outcome. Cut everything else. Be ruthless."
- Posture: surgeon.
- Anti-drift: don't sneak scope back in mid-review.
Step 1. Read the artifact + grounding
- Read the plan/draft in full
- Read
CLAUDE.mdfor project conventions - Read the relevant
memory/projects/<slug>.mdif scoped git log --oneline -10for recent directionrecall("<core topic>")against the recall index for prior decisions / similar work
Step 2. Taste Calibration (EXPANSION + SELECTIVE EXPANSION only)
Identify 2-3 well-designed reference patterns in the existing codebase / prior outputs that are particularly well-crafted. Note them as style references for THIS context. Also note 1-2 anti-patterns to avoid repeating.
Report findings before proceeding to Step 3:
"Reference patterns identified: [X] (this works because Y), [Z] (this works because W). Anti-patterns to avoid: [A] (broken because B)."
Skip for HOLD / REDUCTION modes.
Step 3. Landscape Check (EXPANSION + SELECTIVE EXPANSION only)
Search-before-building gate. Use a web-search tool:
- "[product category or comparable] landscape 2026"
- "[key mechanism] alternatives existing"
- domain comparables if scoped to a specific market (map the incumbents' patterns)
- For a given product category: existing solutions to the same problem
If something obvious already exists and we're proposing to rebuild it, surface that finding as the FIRST decision. before any Prime Directive pass. Lift-vs-build is a strategic call (echoes the repo-audit 4-option triage: doc-mine / clone-audit / install-direct / park).
For HOLD / REDUCTION modes, skip. landscape is already accepted.
Step 4. The 5 Prime Directives (apply across all modes)
For each, walk the plan and flag specific issues with line refs or section names. Don't generic-mention them.
- Zero silent failures. Every failure mode must be visible. to the system, to the operator. If a failure can happen silently (a cron didn't fire, an MCP disconnected, a harvester silently produced nothing, the chat plugin flapped), that's a critical defect. Where does the plan say "log this when it happens"?
- Every error has a name. Don't say "handle errors." Name the specific exception class, what triggers it, what catches it, what the user sees, whether it's logged. Catch-all error handling (
except Exception:/catch Throwable) is a code smell. call it out. - Data flows have shadow paths. Every data flow has 4 paths: happy / null input / empty input / upstream error. Trace all 4 for every new flow.
- Example: a content curator must handle: inputs=null / inputs=empty / harvester-errored.
- Example: a daily synthesis job must handle: scratch-file missing / scratch-file stale / 0 inputs today.
- Interactions have edge cases. Every user-visible action has: double-click / navigate-away-mid-action / slow connection / stale state / back button / chat-disconnect-mid-reply / process-respawn. Map them.
- Observability is scope, not afterthought. Logs, alerts, runbooks, scheduler heartbeats are first-class deliverables. Adding them post-ship is the failure mode. Where is the new functionality's heartbeat? Where does it announce a startup ping? What is the silent-failure detection?
Step 5. Completeness Principle. Boil the Lake
(Adapted from gstack's "Completeness is cheap" principle, aligned with the CLAUDE.md "Boil the Ocean" rule.)
When evaluating "approach A (full, ~150 LOC) vs approach B (90%, ~80 LOC)":
- AI coding compresses implementation time 10-100x
- The 70-line delta costs SECONDS with an AI coding agent
- "Ship the shortcut" is legacy thinking from when human engineering time was the bottleneck
- DEFAULT: prefer the full A unless REDUCTION mode is explicitly selected
Apply this whenever the plan describes a partial-coverage approach.
Step 6. Mode-specific output
EXPANSION mode: propose 3-5 scope-up ideas, each with an effort estimate + value delta. Each one is a separate user question. The user cherry-picks or rejects.
SELECTIVE EXPANSION mode: rigorous review of existing scope (Prime Directives) + 2-3 expansion opportunities surfaced individually. The user picks.
HOLD SCOPE mode: straight-through rigor pass. 5 Prime Directives × every section. Output a punch list of "this section is at 6/10 because X, would be 10/10 with Y."
SCOPE REDUCTION mode: propose the minimum viable cut. What's the smallest version that delivers the core outcome? Strip everything else. Justify each cut with "this isn't load-bearing because Z."
Step 7. Final scoped plan delta
Write the proposed plan diff to the original artifact OR outputs/raw/plan-reviews/YYYY-MM-DD-<slug>-ceo-review.md. Include:
- Mode used (locked since Step 0)
- Scope changes (added/removed/held with reasons)
- Open user-question items (if any)
- Specific Prime Directive flags with line refs
Step 8. Capture Learnings (per §4 of cross-cutting patterns)
If the review surfaced a non-obvious pattern (e.g. "the operator pushes back on scope creep but prefers full-coverage where authorized", "BD-style plans need a landscape check more than tactical plans"), append to memory/Learnings.md per §4 format.
Step 9. Review Chaining (per §5)
After display, recommend the next review:
- Plan touches UI/UX →
/plan-design-reviewnext - Plan is now code-shaped →
/code-reviewnext - Plan is now a public deliverable →
/reviewpipeline - Plan needs sharpening BEFORE more review →
/office-hoursback to start
Format as a structured user question per §1.
Step 10. Completion Status (per §6) + Helicopter check (3 ripples)
Close with an explicit status:
- DONE. Prime Directive flags resolved, mode-output complete
- DONE_WITH_CONCERNS. completed but ≥1 Prime Directive still flagged
- BLOCKED. couldn't proceed
- NEEDS_CONTEXT. missing info to evaluate
Then 3 ripple-effect bullets:
- What other current work does this scope shift affect?
- What memory / knowledge-graph / CRM state needs to update if this ships?
- What downstream skills or crons need to react?
Hard rules
- Mode commitment is non-negotiable. Don't silently drift between modes mid-review.
- Every scope change is an explicit user question. Never silently add or remove scope.
- Boil-the-lake bias: if approach A (full) vs approach B (90%), prefer A unless explicit REDUCTION mode.
- This is a REVIEW skill. Do NOT start implementation. Output is critique + scoped plan delta.
- Prime Directives apply in ALL modes. EXPANSION isn't permission to skip observability.
Anti-pattern this guards against
Plan written → review → "looks good, ship it" → mid-build discovering the original scope didn't account for X / didn't include observability / silently swallowed errors / shipped a 6/10 because nobody asked "could this be a 10?" CEO review forces the strategic conversation BEFORE the build commits.
Sub-anti-pattern: silent mode drift. Mid-review, sliding from EXPANSION ("dream big") to HOLD ("let's just lock this") without telling the user. The mode is a contract. Honor it.
Provenance
Adapted from gstack/plan-ceo-review/SKILL.md (Garry Tan, MIT). Restores Landscape Check + Taste Calibration + Completeness Principle + per-mode posture detail. Stripped (and rejected): the upstream telemetry / update-checker / home-dir state / config bin / proactive auto-suggest / cross-project learnings / autoplan integration / branded report format. Adapted to: the existing /scope, decision-council, repo-audit 4-option triage, recall, domain-tactical examples, a web-search tool. The "Completeness is cheap" principle aligns with the existing CLAUDE.md "Boil the Ocean" rule.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

