Sdlc Ask Wiki
Published by ntanh1402 in sdlc-skills
What this skill does
Answer questions from the project wiki without changing it - list an application's Features with status, spec version, owner, priority, design readiness and open ChangeRequests; list what was written from an older version of a spec; show one Feature's approved architecture with its diagrams, services, frontends, contracts, decisions, traceability and what is not built yet; show one Endpoint or consumer with its input, output, validations and diagrams; show a user story or print its paste-ready c
Add Sdlc Ask Wiki to your agent
Review the source and files first. When you are ready, copy the prompt instruction or use the CLI command supported by your environment.
Install with a prompt
Paste this into a compatible coding agent:
add this skill "sdlc-ask-wiki" from https://github.com/ntanh1402/sdlc-skillsInstall with the CLI
Run this command in a controlled environment after reviewing the repository:
npx skills add https://github.com/ntanh1402/sdlc-skills --skill sdlc-ask-wikiSkill instructions
Ask the wiki
Read-only. Never create, edit, delete or commit a wiki file, and never start a
draft. Route a request to change the wiki to the skill that does it:
sdlc-write-spec (requirements), sdlc-write-stories (user stories),
sdlc-design-arch (architecture),
sdlc-plan-tasks (tasks), sdlc-design-story-tests and
sdlc-design-feature-tests (test design),
sdlc-import (existing code, documents or tests to bring into the wiki, or
to compare with it), sdlc-close-task (a Task whose code is merged),
sdlc-edit-wiki (a typo, the glossary or conventions, a Feature marked
released, a ticket link on a Task or a user story), sdlc-setup-wiki (the wiki itself, or a new
Application). A request to write a Task's code goes to sdlc-build-task, and
one to review a code change to sdlc-review-code.
Read references/read-protocol.md in this skill's folder and follow it: it
finds the wiki, says how to read the default branch, and where the schema
pages are. Read the schema page of a type before relying on its headings or
statuses.
How to answer
- Ask only for what is genuinely missing: an Application when there are several and the question does not say which, or a Feature when several match.
- Search cheaply first (indexes,
grep -rl), then read only the files the answer needs. - Answer the question first, then cite the paths you read. Separate what the wiki says from what you infer. When nothing is found, say what you searched.
- Do not paste whole files when a short interpreted answer does.
Recipe: list features
For one Application (ask which if there are several), read
wiki/<app>/features/index.md and each Feature's overview.md. Report one row
per Feature:
| Column | From |
|---|---|
| Key and title | frontmatter |
| Status | status (the values are on the Feature schema page) |
| Version | version and versionDate |
| Owner, priority | ownerTeam, priority |
| Designed | # Architecture is not None; "from v<n>" with designBasedOn, marked outdated when it is older than version |
| Not live | number of Design concepts whose # Pending changes links this Feature |
| Open changes | ChangeRequests listed in its # Change history whose status is in pending.open_requests of .wiki-llm/schema/schema.json |
Explain an empty list. Offer "show the architecture of FEAT-x" for detail.
Recipe: show a feature's architecture
For exactly one Feature:
- Summary: title, status, version, owner, and the design state: not
designed yet, designed from version
designBasedOn(outdated when that is older thanversion), orApproved. A Feature that is designed but notApprovedhas Requirements that are a draft or a design that is behind; say which. - Requirements: key, priority and one line each.
- The stored diagrams from
## High-level architectureand## Runtime sequences, as they are. - Frontends (only when
## Frontendsexists): each one's status, its routes or screens, and the Endpoints and Operations under its# Calls. - Services: each one's status, its Endpoints and Subscriptions, the channels it publishes, the tables and stores it uses, and the externals it calls.
- Decisions under
## Decisions, with their consequences. ## Traceability, Requirement by Requirement.- References the Feature links under
# References, with their notes. - Not live: every concept with a
# Pending changesentry for this Feature or one of its ChangeRequests, with the entry's text; and the open ChangeRequests. - Outdated:
$T outdated --feature <key>lists the design, stories, Tasks and TestGroups written from an older version, with the skill that rewrites each (sdlc-design-arch,sdlc-write-stories,sdlc-plan-tasks,sdlc-design-story-testsorsdlc-design-feature-tests). Leave this out when it is empty. - Gaps found while reading: links that do not resolve, Requirements missing
from Traceability, differences between the wiki and code you also read
(
sdlc-importon that code compares them file by file).
A Feature with # Architecture None is not an error: say it is not designed
yet and that sdlc-design-arch can design it now, even while its
Requirements are a draft.
Recipe: what is outdated
"What must be redone since the spec changed?" Run
$T outdated --feature <key> (or --change <key>). Report the target's
version and date, then one row per file it lists: the path, what it is, the
version it was written from, and the skill that rewrites it. A person may
instead confirm that a file is still current with sdlc-edit-wiki.
Recipe: show an endpoint or a consumer
For exactly one Endpoint or Subscription:
- Summary: title, status, its Service, and
methodandpath, or the channel it consumes. - Input:
# Request, or the channel's payload linked from# Consumes. - Output:
# Responsewith## Status codes, or the side effects named in# Handler. # Validations, as stored.# Behavioror# Handler.- The stored
# Flowchartand# Sequence diagram, as they are. # Pending changes, when present, with each entry's text.
Recipe: show a user story
Stories are STORY-*.md files in a Feature's or ChangeRequest's folder
(user-story.md). For one story, give its sentence, its criteria, the
Requirements it lists, the Tasks whose # Stories link it, and its
# Changed by entries: a Feature story describes the Feature as first
delivered, and the ChangeRequest stories listed there describe later changes.
For "the paste-ready copy", "give me the story for the tracker" or similar,
print each story asked for as references/paste-format.md shows, and
nothing else.
Free-form questions
- "What uses X?": open X and read its tool-written reverse section
(
# Used by,# Publishers,# Subscribers, a Reference's# Referenced by), elsegrep -rl "<KEY>" wiki/. - "What should I read about X?", "is there an example of Y?": the References
in
wiki/<app>/references/index.mdwhose title or description matches, and those the concepts about X link under# References. Give each one's description, status andresource, and say when it isDeprecatedor past itsstale_after. - "What is not live?":
grep -rl "^# Pending changes" wiki/, then read the entries. - "What is not tested, not planned or has no story?":
coverage tests,coverage tasksandcoverage stories(read-protocol section 3).coverage storiesreporting every Functional Requirement means the Feature has no stories, which is allowed. - "Why is it like this?": the decisions in
wiki/<app>/decisions/, the concept'slog.md, thengit log -pon its folder. - "Who confirmed it?": the
verifiedstamps; a file without one is unconfirmed. - "How far is this Task?": a Task is
Todountil its code is merged, thenDone. Say that progress in between is in the Tracker, and give the Task'strackerKeyandresourcewhen it has them.
Files included
- agents/openai.yaml
- references/paste-format.md
- references/read-protocol.md
- SKILL.md

