mcpField
S
sdlc-create-intent

sdlc-create-intent

github.com/wesleycamargoOther039 installsUpdated 3w ago
Repository

About sdlc-create-intent

A workflow skill for turning an informal request into a scoped SDLC intent document. It is for teams starting repository work and focuses on clarifying outcomes, boundaries, constraints, and unresolved questions before specification or implementation.

Key features

  1. 01Creates an intent.md artifact
  2. 02Identifies problem and desired outcome
  3. 03Records scope and non-goals
  4. 04Captures constraints and open questions
  5. 05Defers specification and coding

Use cases

  1. 01Starting an SDLC work item from a request
  2. 02Clarifying bug impact and expected behavior
  3. 03Recording refactor invariants before planning

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wesleycamargo/devcontainer-template --skill sdlc-create-intent

After installing, type/sdlc-create-intentin Claude Code to confirm it loaded.

Details

From the project README

Create intent

Position

This is the first SDLC stage. Given an informal request, create sdlc//intent.md. Do not create spec.md, plan.md, tasks, or code.

Inputs and output

  • Required input: the request. Inspect repository instructions and relevant conventions when they can affect scope or constraints.
  • Output: a self-contained intent artifact in a short lowercase kebab-case work-item directory. Include an external work-item ID when supplied; never require one.

Responsibilities

Find the underlying problem or opportunity, desired outcome, included scope, non-goals, affected users, systems, or capabilities, material constraints, and measurable success indicators when appropriate. Separate requested outcomes from suggested solutions. Capture material ambiguities, assumptions, and open questions without inventing business decisions or expanding scope.

For bugs, describe actual behavior, expected behavior, and impact. For technical debt, describe the current risk or cost. For features, describe the capability and enabled outcome. For refactors, explain why it is needed and behavior that must remain unchanged.

Use only relevant sections, typically:

`markdown

Intent:

Problem

Desired Outcome

Scope

Non-Goals

Constraints

Success Criteria

Open Questions

`

Ask a question only when the answer materially changes intent. Ask through the agent's interactive question tool (Claude Code: AskUserQuestion), grouping related questions in one call, with 2-4 suggested options each, the recommended one first and labeled "(Recommended)", so the user answers with buttons; use plain text only when no such tool exists. Record a reasonable noncritical assumption instead of blocking. Do not choose a technology or architecture unless it is a confirmed constraint.

Handoff

Request human review when appropriate. Once the intent is approved, hand off to sdlc-create-spec with the work-item path. A later change to outcome or scope requires revising this artifact before downstream work relies on it.

Comments

Markdown supported