Skip to content

Add before-you-build planning skill#5

Open
bin1874 wants to merge 1 commit into
proflead:masterfrom
bin1874:codex/add-before-you-build-skill
Open

Add before-you-build planning skill#5
bin1874 wants to merge 1 commit into
proflead:masterfrom
bin1874:codex/add-before-you-build-skill

Conversation

@bin1874

@bin1874 bin1874 commented May 31, 2026

Copy link
Copy Markdown

Summary

Adds a small before-you-build planning skill for pressure-testing product ideas and major feature requests before implementation starts.

Why it fits

The library already includes planning and decision-support skills such as roadmap prioritization, vendor evaluation, and system design. This adds a pre-build product-risk checkpoint for founders, PMs, and senior developers who are about to turn an idea into code.

Scope

  • Adds skills/planning/before-you-build/SKILL.md
  • Adds the skill to the Planning section in README.md
  • Keeps the skill concise and implementation-agnostic

Validation

  • Ran git diff --check

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new skill called before-you-build under skills/planning/ to pressure-test product ideas or features before implementation. The review feedback suggests shortening the descriptions in both the README.md and the skill's frontmatter to maintain consistency with existing skills. Additionally, it recommends updating the quality bar instructions so that the LLM makes reasonable assumptions and lists clarifying questions instead of simply asking questions when an idea is too broad.

Comment thread README.md
- [`refactor-roadmap`](skills/planning/refactor-roadmap/SKILL.md): Sequence refactors with tests, flags, and checkpoints.
- [`tech-debt-portfolio`](skills/planning/tech-debt-portfolio/SKILL.md): Catalog debt, estimate impact, and prioritize with ROI.
- [`roadmap-prioritization`](skills/planning/roadmap-prioritization/SKILL.md): Score initiatives by impact, effort, and dependencies.
- [`before-you-build`](skills/planning/before-you-build/SKILL.md): Pressure-test a product idea or feature before implementation by identifying the biggest demand, positioning, monetization, retention, and distribution risks.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The description for the before-you-build skill is significantly longer than the other descriptions in this section, which are typically around 60 characters. Consider shortening it to maintain visual consistency and readability, for example:

  • before-you-build: Pressure-test a product idea or feature for key risks before implementation.

@@ -0,0 +1,36 @@
---
name: before-you-build
description: Review a product idea or feature before implementation by identifying the biggest demand, positioning, monetization, retention, and distribution risks. Use when a senior developer or founder wants to build a new product, landing page, MVP, or major feature but needs a reality check first.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The frontmatter description is quite long compared to other skills in the repository. Shortening it to focus on the core purpose and target audience will align it better with the existing style.

Suggested change
description: Review a product idea or feature before implementation by identifying the biggest demand, positioning, monetization, retention, and distribution risks. Use when a senior developer or founder wants to build a new product, landing page, MVP, or major feature but needs a reality check first.
description: Pressure-test a product idea or feature for key risks before implementation. Use when a founder or developer needs a reality check before building.

- Do not recommend tech stacks, architecture, or implementation details.
- Be direct and concrete, not motivational.
- Prefer one sharp risk over a long generic checklist.
- If the idea is too broad, ask who it is for, when they use it, and what painful problem it replaces.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Instructing the LLM to simply ask questions when an idea is too broad can lead to incomplete or unhelpful single-turn responses. It is better to have the LLM make reasonable assumptions to proceed with the analysis while explicitly listing the clarifying questions needed to validate those assumptions.

Suggested change
- If the idea is too broad, ask who it is for, when they use it, and what painful problem it replaces.
- If the idea is too broad, make reasonable assumptions to narrow it down for the analysis, and clearly list the clarifying questions needed to validate those assumptions.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant