Skip to content

Commit a46cfb8

Browse files
committed
Update development with AI DevKit doc
1 parent a11e3d8 commit a46cfb8

File tree

1 file changed

+56
-3
lines changed

1 file changed

+56
-3
lines changed

web/content/docs/3-development-with-ai-devkit.md

Lines changed: 56 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -49,9 +49,62 @@ docs/ai/
4949

5050
> **Tip:** You don't have to complete all phases in one session. AI DevKit saves your documentation, so you can pick up where you left off.
5151
52+
## Using the Dev Lifecycle Skill
53+
54+
Instead of manually typing each command, you can use the `dev-lifecycle` skill to guide you through the entire workflow automatically. The skill triggers the next phase for you whenever the current phase is complete — no need to remember which command comes next.
55+
56+
### Installing the skill
57+
58+
Install the `dev-lifecycle` skill from the AI DevKit registry:
59+
60+
```bash
61+
ai-devkit skill add codeaholicguy/ai-devkit dev-lifecycle
62+
```
63+
64+
or
65+
66+
```bash
67+
npx ai-devkit skill add codeaholicguy/ai-devkit dev-lifecycle
68+
```
69+
70+
Once installed, the skill is immediately available to your AI agent. For more details on managing skills, see [Skills](/docs/skills).
71+
72+
### How to use it
73+
74+
Tell your AI assistant to use the skill and describe what you want to build. For example:
75+
76+
> "Use dev-lifecycle skill to build a feature to update the agent memory"
77+
78+
The skill takes over from there:
79+
80+
1. It walks you through **requirements gathering** — asking clarifying questions about your feature
81+
2. Once requirements are clear, it automatically moves to **requirements review**
82+
3. Then proceeds to **design review**, **planning**, **implementation**, **testing**, and **code review**
83+
84+
You don't need to type `/review-requirements`, `/review-design`, or any other command manually — the skill handles phase transitions for you.
85+
86+
### Automatic phase progression
87+
88+
The key difference from running individual commands: the skill **suggests and triggers the next phase** after each one completes. If a review phase finds issues, it loops back to the right phase automatically.
89+
90+
| Scenario | What Happens |
91+
|----------|--------------|
92+
| Requirements review finds gaps | Loops back to requirements to fill them |
93+
| Design review finds requirement issues | Loops back to requirements review |
94+
| Implementation doesn't match design | Loops back to design or implementation |
95+
| Tests reveal design flaws | Loops back to design review |
96+
97+
### Resuming work
98+
99+
If you started a feature in a previous session, the skill can pick up where you left off. It checks your existing documentation to determine which phase you're in and continues from there.
100+
101+
> **When to use the skill vs. individual commands:**
102+
> - Use the `dev-lifecycle` skill when starting a new feature or continuing end-to-end work — it handles the flow for you
103+
> - Use individual commands (like `/code-review` or `/writing-test`) when you only need one specific phase
104+
52105
## Refinement Commands
53106

54-
After the initial pass, use these commands to refine your work:
107+
If you're using the `dev-lifecycle` skill, these commands run automatically as part of the workflow. You can also run them individually when you need a specific phase:
55108

56109
### `/review-requirements`
57110

@@ -137,7 +190,7 @@ After the initial pass, use these commands to refine your work:
137190

138191
## Tips for Success
139192

140-
1. **Don't skip phases** — Each phase builds context for the next
193+
1. **Don't skip phases** — Each phase builds context for the next. The `dev-lifecycle` skill handles this automatically
141194
2. **Keep docs updated** — Use `/update-planning` when things change
142195
3. **Review before committing**`/code-review` catches issues early
143196
4. **Be specific** — The more detail you give, the better your AI assistant can help
@@ -146,4 +199,4 @@ After the initial pass, use these commands to refine your work:
146199

147200
- **Debug effectively** — See [Debugging with AI DevKit](/docs/4-debugging-with-ai-devkit)
148201
- **Understand existing code** — See [Understanding Existing Code](/docs/5-understand-existing-code-with-ai-devkit)
149-
- **Give your AI memory** — See [Memory](/docs/6-memory)
202+
- **Give your AI memory** — See [Memory](/docs/6-memory)

0 commit comments

Comments
 (0)