Agentic_programming-course create-doc

Create or improve documentation based on the current conversation. Use this when a plan has been created and changes were requested because it didn’t follow the repository’s conventions.

install

source · Clone the upstream repo

git clone https://github.com/CodelyTV/agentic_programming-course

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/CodelyTV/agentic_programming-course "$T" && mkdir -p ~/.claude/skills && cp -r "$T/04-skills/2-create_doc/.agents/skills/create-doc" ~/.claude/skills/codelytv-agentic-programming-course-create-doc && rm -rf "$T"

manifest: 04-skills/2-create_doc/.agents/skills/create-doc/SKILL.md

source content

Based on the current conversation, create new or improve existing documentation files inside the

docs/

folder.

Steps

Identify conventions, patterns, or decisions discussed in the conversation that should be documented.
Check if a relevant doc already exists in
```
docs/
```
(organized by area:
```
backend/
```
,
```
frontend/
```
,
```
database/
```
, etc.).
- If it exists, improve it while preserving the required structure.
- If it does not exist, create a new file in the appropriate subfolder.
Read @docs/documentation-guidelines.md and follow its structure exactly. Every document MUST include these sections in order:

# 🎯 Name of the convention

## 💡 Convention
## 🏆 Benefits
## 👀 Examples (with ✅ Good and ❌ Bad subsections)
## 🧐 Real world examples
## 🔗 Related agreements

Ask the user to confirm the target file path before writing.
Update the AGENTS.md index with the new doc.

Rules

Each convention goes in its own standalone Markdown file — never bundle multiple conventions into one doc.
Place files in the correct area subfolder (
```
backend/
```
,
```
frontend/
```
,
```
database/
```
,
```
testing/
```
, etc.).
Include concrete good and bad examples with code blocks when applicable.
Link to real files in the codebase that follow the convention in the "Real world examples" section.