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
- 01Creates an intent.md artifact
- 02Identifies problem and desired outcome
- 03Records scope and non-goals
- 04Captures constraints and open questions
- 05Defers specification and coding
Use cases
- 01Starting an SDLC work item from a request
- 02Clarifying bug impact and expected behavior
- 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-intentAfter installing, type/sdlc-create-intentin Claude Code to confirm it loaded.
Details
From the project READMECreate 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.