sdlc-artifacts
Skill5 starsChanged 46 days agoMITView on GitHub
use this when writing or updating an HLD, LLD, ticket, epic, groom plan, track/roadmap, PoC note, decision, changelog, PR, monthly note, human how-to, or AGENTS stub that the SDLC calls for — copy the matching template and fill required fields. do not use to invent a second process or to skip a gate.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- haco29/agentic-sdlctheir own version, first seen Oct 20, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- haco29/agentic-sdlc★ 0same name
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 repository49 other files it gives its agents.
- AGENTS.mdAGENTS.md
- maintainers/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- buying-researcherSkill
- cursor-cloud-agents-whenSkill
- debug-anthropicSkill
- debug-pocockSkill
- debugSkill
- discover-the-ideaSkill
- docs-google-styleSkill
- golang-safetySkill
- golang-securitySkill
- golang-testingSkill
- grok-acpSkill
- host-config-pyinfraSkill
- lang-cppSkill
- lang-csharpSkill
- lang-cSkill
- lang-dartSkill
- lang-dockerSkill
- lang-goSkill
- lang-javaSkill
- lang-js-tsSkill
- lang-kotlinSkill
- lang-luaSkill
- lang-makefileSkill
- lang-phpSkill
- lang-powershellSkill
- lang-protobufSkill
- lang-pythonSkill
- lang-rubySkill
- lang-rustSkill
- lang-shellSkill
- lang-sqlSkill
- lang-swiftSkill
- lang-terraformSkill
- language-routerSkill
- lang-web-markupSkill
- modern-pythonSkill
- pr-reviewSkill
- sdlc-onboardingSkill
- security-hardeningSkill
- shell-safetySkill
- tddSkill
- tracker-sdlcSkill
- ui-craftSkill
- ux-designSkill
- verify-before-doneSkill
- yagniSkill
The file
Files
SDLC artifacts
Fill-in shapes for artifacts the SDLC already requires. Process lives in
docs/SDLC.md. Copy a template; do not paste the
SDLC into the artifact. No scripts/.
Iron law
One template per artifact. Fill every required field or write n/a
and why. Do not invent a parallel outline.
Map
| Artifact | Step | Template | Lands in |
| Brief (chunk) | Brief | discover-the-idea (not here) | Chat unless asked to file |
| Incoming item | Brief | templates/bug.md / task.md | Same files as Groom; fill Proposed fix / Removal / Pick at Brief, not later |
| Track / roadmap | Plan | templates/track.md | Board project; git copy optional |
| Chunk / epic | Brief–Groom | templates/chunk.md | Board parent issue |
| Groom plan | Groom | templates/groom.md | .agents/design/<chunk>/groom.md (this skills home: maintainers/design/<chunk>/groom.md); frozen after filing |
| HLD | Plan | templates/hld.md | docs/hld.md or docs/<slug>/hld.md |
| Comparables | Plan | templates/comparables.md | docs/comparables.md or docs/<slug>/comparables.md |
| UX / journeys | Plan | templates/ux.md | docs/ux.md or docs/<slug>/ux.md |
| User story | Plan | templates/user-story.md | docs/stories/ or the board |
| PoC | Trial | templates/poc.md | poc/poc.md beside the chunk's design records: Trial |
| LLD | Spec | templates/lld.md | docs/lld.md or docs/<slug>/lld.md |
| Mockups | Spec | templates/mockup.md | docs/mockups/ (or n/a) |
| Decision | any | templates/decision.md | docs/decisions/<slug>.md |
| Task | Groom | templates/task.md | Board issue, label Task |
| Bug | Groom | templates/bug.md | Board issue, label Bug |
| Changelog | Build / Changelog | templates/changelog.md | repo-root CHANGELOG.md |
| PR / land | Review | templates/pr.md | PR body or land commit message |
| Monthly | Monthly | templates/monthly.md | docs/monthly/, or a Task once filed |
| Human doc | Spec+ | templates/human-doc.md | docs/ how-to (Google style) |
| Ask the operator | any gate | templates/ask-human.md | The message to the operator — not a git file |
| AGENTS stub | Repo | templates/agents-stub.md | product-repo AGENTS.md |
| Repo tracker skill | Brief (onboarding) | templates/tracker-skill.md | product-repo .agents/tracker/SKILL.md |
Always
- Copy the file. Delete unused optional sections. Keep required ones.
- Link the layer above and below (track → chunk → item; HLD → LLD → ticket). A changelog line cites the ticket ID and the land SHA.
- Tracker: only the manager writes it: Tracker.
The manager files a ticket body with
tracker-sdlccreate, posts later fields or a design's git path withcomment(no edit verb), and sets blockers with set-blocker, not only as text. - Dates ISO-8601. Slugs lowercase hyphen.
Ask first
- A new artifact type that is not in the map.
- Skipping a required field other than with
n/a+ why.
Never
- A second HLD/LLD/ticket outline “just this repo.”
- Cloning the
discover-the-ideabrief intotemplates/. - Empty acceptance or empty trust-boundary section on an LLD that touches a boundary.
- Language skills on a templates-only turn.
Red flags
- “I’ll freehand the HLD”
- “Acceptance is ‘it works’”
- “No blockers, we’ll sequence in chat”
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.