# Skill Sdd Generate Docs

> Lean SDD, generate documentation artifacts for a completed AL feature. Triggers on: speckit.docs, generate docs, lean SDD docs, update changelog, write documentation, document feature.

- **Type:** Skill
- **Install:** `agentstack add skill-louage-frw-agentic-coding-skill-sdd-generate-docs`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Louage](https://agentstack.voostack.com/s/louage)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Louage](https://github.com/Louage)
- **Source:** https://github.com/Louage/frw-agentic-coding/tree/main/assets/generated/aldc-community/skills/skill-sdd-generate-docs

## Install

```sh
agentstack add skill-louage-frw-agentic-coding-skill-sdd-generate-docs
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Skill: Lean SDD, Generate Docs

## Purpose

Generate lightweight documentation artifacts for an AL feature after all AC rows in `tasks.md` are validated. Output targets:
1. **Inline AL code**, XML doc comments on public procedures (`/// `)
2. **CHANGELOG.md**, one entry in Keep-a-Changelog format
3. **`tasks.md`**, mark the docs task as done

This step is intentionally **lean**, document only what a future developer or reviewer needs to understand the intent; do not add noise comments on trivial or self-explanatory code.

## When to Load

Load when:
- The user says `/speckit.docs`, "generate docs", or "document feature"
- All AC rows in `tasks.md` are checked
- Tests pass (`run-al-tests` step is done)

## Prerequisites

1. `specs//tasks.md`, all AC rows ✅
2. `specs//spec.md`, for summary and purpose language
3. AL source files for the feature are in `app/src/{FeatureName}/`

## Step 1, Read Context

```
Read specs//spec.md    → feature title, summary, AC list
Read specs//plan.md    → implemented objects (file map)
Read app/src/{FeatureName}/  → list AL files to document
```

> `` is the dated subfolder under `specs/SDD/`, e.g. `specs/SDD/2026-07-08-fleet-registration/`.

## Step 2, Add XML Doc Comments to Public Procedures

For every `procedure` that is **public** (no `local` keyword) in the feature's codeunit(s):

```al
/// 
/// {One-sentence description of what the procedure does.}
/// 
/// {Description.}
/// {Description of return value, if any.}
procedure {ProcedureName}({ParamName}: {Type}): {ReturnType}
```

Rules:
- Skip `local` procedures, they are implementation details
- Skip trivial getters/setters where the name is fully self-explanatory
- Keep summaries to one sentence; use plain BC terminology

## Step 3, Update CHANGELOG.md

If `CHANGELOG.md` does not exist, create it with the [Keep a Changelog](https://keepachangelog.com) format.

Prepend the feature entry under `## [Unreleased]`:

```markdown
## [Unreleased]

### Added
- **{feature-title}**, {one-sentence summary} ([spec](/spec.md>))

### Changed
- {only if an existing behavior was altered}

### Fixed
- {only if a bug was fixed as part of this feature}
```

## Step 4, Update `tasks.md` Documentation Row

```markdown
- [x] Docs: XML comments on public procedures ✅
- [x] Docs: CHANGELOG.md updated ✅
```

## What NOT to Document

- `local` procedures (internal implementation)
- Variable declarations (names should be self-explanatory per naming conventions)
- Event subscribers (the event name describes the trigger)
- Test procedures (the Given/When/Then structure is already documentation)

## Skills Evidencing

```
> **Skills loaded**: skill-sdd-generate-docs (docs phase)
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Louage](https://github.com/Louage)
- **Source:** [Louage/frw-agentic-coding](https://github.com/Louage/frw-agentic-coding)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-louage-frw-agentic-coding-skill-sdd-generate-docs
- Seller: https://agentstack.voostack.com/s/louage
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.