proposal
/proposal
Use to author proposal.md for a change — the Scope Proposal (Phase 1A). Runs after an optional scope grill and produces a single artifact defining business rationale and an explicit IN-SCOPE vs OUT-OF-SCOPE contract, then hands off to the review gate.
- Author
- bienwithcode ↗
- Repository
- sdlaic ↗
- Licence
- MIT
- Last repository change
- 03.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 03.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use to author proposal.md for a change — the Scope Proposal (Phase 1A). Runs after an optional scope grill and produces a single artifact defining business rationale and an explicit IN-SCOPE vs OUT-OF-SCOPE contract, then hands off to the review gate.
Original author description
Use to author proposal.md for a change — the Scope Proposal (Phase 1A). Runs after an optional scope grill and produces a single artifact defining business rationale and an explicit IN-SCOPE vs OUT-OF-SCOPE contract, then hands off to the review gate.
How it works
- Core Principle
- Pre-conditions
- Process
- Output Artifacts
- Verification
- Common Mistakes
- Handoff / Gate
SKILL.md preview
--- name: proposal description: Use to author proposal.md for a change — the Scope Proposal (Phase 1A). Runs after an optional scope grill and produces a single artifact defining business rationale and an explicit IN-SCOPE vs OUT-OF-SCOPE contract, then hands off to the review gate. --- # Scope Proposal Phase (Proposal) ## Core Principle The proposal is the **scope contract** — why the change is needed and, above all, an explicit boundary between what is IN scope and what is OUT of scope. It locks down "what" before any spec, design, or code exists, so nothing downstream can drift beyond the agreed boundary. This skill produces exactly one artifact: `proposal.md`. It does not design, specify behavior, or plan. ## Pre-conditions - An active SDLAIC change exists (`context.md` may exist with ticket context — optional). - If the workflow level is `strict`, the scope grill has run first (see Handoff / Gate). ## Process ### Step 1: Absorb the input Read `context.md` — especially `## Prior Agreement`, `## Candidate Scopes` (the decomposed scope set with `Kind`, `Readiness`, `✅ AGREED` / `REFUTED` dispositions and any `⚠ OVERLAPS`), `### Refuted — boundaries`, and `### Selected for this change` — and the originating ticket. Identify the problem, its business rationale, and the affected area. Run a codebase-research query to ground the affected-area claims in real paths — do not assume. ### Step 2: Decide the gated IN/OUT-OF-SCOPE boundary This is where scope is **decided and gated** — `new` only proposed candidates; the gate lives here. Start from `context.md > ### Selected for this change`: those capabilities go **IN**; every other candidate becomes **OUT** with a reason (`DEFERRED` / `OUT-OF-SCOPE` / `DUPLICATE` / `REFUTED` / `WONTFIX`). `grillme` has already pressure-tested the candidate set and the `REFUTED` dismissions — honor or overturn them here with justification. **A `✅ AGREED` scope cannot be moved OUT on your own judgement.** It carries a recorded approval (author + date + quote). Moving one OUT requires either the user's explicit instruction in this session, or a blocker discovered in research that the approver could not have known about — and the reason column must cite which, quoting the original approval. Absent that, an `AGREED` scope is IN. Carry the ordering from `### Selected for this change` (`ready-now` before blocked) into `## What Changes` — a `needs-sizing` capability must not gate a `ready-now` one. Before writing prose, enumerate the boundary; every item a reader might assume is included must be explicitly placed IN or OUT. Ambiguity here is the primary cause of generative overreach. ### Step 3: Write `proposal.md` Request the template guidance, then write to `$(sdlaic path change --change <name>)/proposal.md`: ```markdown # Proposal: <change-name> **Change ID**: `<change-name>` **Ticket**: <KEY> (<summary>) ## Why [One paragraph: the problem this change solves and its business rationale.] ## Scope | IN SCOPE | OUT OF SCOPE (with reason) | |----------|--------------| | [thing this change will do — from `### Selected for this change` in context.md] | [related thing it will deliberately NOT do — DEFERRED / OUT-OF-SCOPE / DUPLICATE / REFUTED / WONTFIX: <one-line why>] | | ... | ... | ## What Changes - **[Bug fix / Enhancement / New feature]: [description]** - [Specific change] ## Success Criteria - [ ] [Testable criterion tied to the ticket] ## Impact - **Affected area (indicative)**: [key modules/paths] - **Breaking changes**: [None intended / list] ``` The **Scope table** is mandatory. Grill resolutions are applied directly into the content (Scope rows, Why, What Changes) by the draft skill — there is no separate log section. ### Step 4: Hand off to the review gate Do not advance to the spec phase yourself. Emit a summary and hand off (see Handoff). ## Output Artifacts - `$(sdlaic path change --change <name>)/proposal.md` — scope contract with a mandatory IN/OUT-OF-SCOPE table. ## Verification - [ ] `proposal.md` exists and is populated (no template placeholders). - [ ] The Scope table has ≥1 IN-SCOPE and ≥1 OUT-OF-SCOPE row. - [ ] Success Criteria has ≥1 testable criterion tied to the ticket. - [ ] No technical design or task breakdown leaked into the proposal (that is design/plan). - [ ] Grill resolutions are reflected in the content (Scope table / Why / What Changes), not in a separate log. ## Common Mistakes | Mistake | Fix | |---------|-----| | Mixing "how" into the proposal | Proposal is scope (why/what). Keep architecture in `design.md`. | | Vague or absent OUT-OF-SCOPE column | Every plausible-but-excluded item must be named OUT (with a reason). This is the anti-overreach control. | | Re-decomposing the ticket instead of using `context.md > ## Candidate Scopes` | `new` already decomposed the ticket into candidates with Kind + Readiness + dispositions, and recorded the user's multi-select in `### Selected for this change`. Start there: selected → IN, the rest → OUT with reasons. Don't re-derive the candidate set. | | Moving a `✅ AGREED` scope OUT because it looks low-value or expensive | Not yours to decide — it carries a recorded approval. Only an explicit user instruction, or a blocker the approver could not have known about, justifies it; cite which, and quote the original approval. | | Writing spec scenarios here | Behavioral GIVEN/WHEN/THEN belong in `skills/spec`. | | Advancing to spec without the gate | The proposal gate must be `approved`/`skipped` first. | ## Handoff / Gate 1. **Grill first (strict):** the scope grill (bundled with `skills/grillme`) runs before drafting; its resolutions are applied into the Scope table and content sections. 2. **Review after:** hand the drafted `proposal.md` to `skills/review` for the `proposal` audit (checklist bundled with the review skill). 3. The reviewer records the verdict via `sdlaic gate set --phase proposal --status <approved|failed> [--verdict ...]` — never inside the repo. 4. On `approved`, the enforcer advances to Phase 1B (`skills/spec`). On `failed`, re-draft here and increment the attempt.
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · bienwithcode/sdlaic | 100 | MIT |
| octavehq/lfgtm | 100 | MIT |
| diegorezm/proposal-skill | 100 | MIT |
| adeerkhan/vitruvius | 100 | MIT |
Database snapshot: 13.11.2026 · package version 25109ebe42c0 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100design
Use to author design.md for a change — the Technical Architecture phase (Phase 2). Runs after an approved spec and an optional design grill, producing the architecture that satisfies the proposal and spec, then hands off to the review gate. - 100spec-research
Write OpenSpec proposal.md artifacts (why + what). TRIGGER when: capturing requirements, scope, and impact for a spec-driven feature. SKIP: technical design (use spec-design); external documentation research (use research-methodology). - 90proposal-review
Adversarial review of a proposal — challenges the why, what, and how, and suggests concrete alternatives. Use when asked to review a proposal, challenge an idea, stress-test an approach, or provide a devil's advocate perspective before specs or design are written. - 100proposal-writer
Write a client proposal, quote, scope of work, or engagement letter for a service business. Covers project understanding, scope, timeline, pricing presentation, and terms. Use whenever the user asks for a proposal, quote, project proposal, client proposal, SOW, statement of… - 100spec
Use to author specs/<capability>/spec.md for a change — the Behavioral Requirements phase (Phase 1B). Runs after an approved proposal and an optional spec grill, producing formal GIVEN/WHEN/THEN scenarios, then hands off to the review gate. - 98discuss-proposal
Discuss and review an improvement proposal with the user. Analyzes strengths, weaknesses, feasibility, and cost estimate. Records the review as a persistent comment on the proposal, and optionally creates a revision if concrete improvements are identified. Use when the user says…