Document Implement

STOP - Read before ANY tool call

1. Read {{GUARDRAILS_PATH}}
2. Read _shared/sdd-artifacts/SESSION.md; load session-state for $Cwd
3. If the relevant gate is not approved: STOP - ask user (pt-BR) - do NOT Write/Shell
4. SDD/develop skills: after ONE step/task, STOP session - handoff only
5. This skill body is English; user-facing prompts may be (pt-BR)

Step -1 - Gate check (report in chat before continuing)

Gate check:
[ ] guardrails.mdc read
[ ] SESSION.md read; session-state loaded
[ ] PIPELINE.md read (SDD skills only)
[ ] User confirmed current action (sim)
-> If any unchecked: STOP

Skill: document-implement

Trigger

Invoke when the user asks for: /document-implement, document repository, /document-implement, or execute documentation plan.

Requires docs/documentation-plan/plan.md in the target workspace. If missing, hand off to /document-plan (do not invent steps).

Outcome

One documentation plan step completed in the target repo: new/updated markdown under docs/, plan progress advanced, next step identified for a future session.

Lazy-load

Never by default: do not preload all references/*.md, full document-plan packs, or unrelated SDD contracts. Load one references/<section>.md per Process step (SKILL-REFERENCE-RETRIEVAL.md).

Process

Read references/<section>.md for execution detail — not full reference.md.

Step -1b - Caveman Mode (Full cap)

1. Read {{SDD_ROOT}}/preferences.json (create { "caveman_mode": false, "caveman_level": "full" } if missing).
2. If caveman_mode is false: continue without compression.
3. If true: load {{TOOLKIT_ROOT}}/skills/_shared/caveman/CAVEMAN.md; apply Full participation cap + prefs caveman_level (Lite skills never escalate); show once: [Caveman] Modo ativo (respostas compactas, level={effective}). Digite caveman off para desativar.
4. Honor caveman on|off|status|lite|full|ultra (and stop caveman / normal mode) during the session.
5. Auto-Clarity + never-compress gates/drafts/paths per CAVEMAN.md.

0. Workspace, plan, and stack

1. Confirm target repository.
2. Resolve doc plan path = absolute $Cwd/docs/documentation-plan/plan.md (or user-given alternate). If absent -> stop and suggest /document-plan.
3. Load/create develop session keyed by that full plan path per SESSION.md (plan-{plan-hash}.json). Gates step_confirmed / tests_run live only there - never use flat {repo-hash}.json for them.
4. Read the plan. Read Doc language from plan header. If missing, ask: pt-BR or English before writing docs/ (references/doc-language.md).
5. Re-detect stack briefly (Glob per document-plan/references/stack-detection.md) if plan is stale.

Not Classic SDD / Orchestrated Delivery: only the documentation plan applies here - not features/**/PLAN/. For feature delivery PRD/PLAN, use sdd-spec / sdd-plan / sdd-develop and STORAGE.md. Prerequisite rules: references/prerequisite.md.

1. Select step

Pick the first step with Status: Pending (or Pendente) whose dependencies are completed (references/step-selection.md). If user names a step id, use that step after validating deps.

Summarize objective and deliverables. If step_confirmed is false: ask (pt-BR) to implement this doc step; set gate true only after sim.

2. Execute step

Follow the step's Tasks in the plan (references/writing-guidelines.md):

• Glob/Grep/Read source; document facts evidenced in code/config
• Write paths listed in Deliverables (e.g. docs/domains/<slug>.md)
• Use doc language from plan; keep file paths and type names in English
• No secrets, tokens, or internal-only URLs in markdown

3. Update plan

Before marking the step done: set tests_run=true on the scoped develop session after reporting what was written (doc verification - no app test suite required).

Edit docs/documentation-plan/plan.md in place per references/plan-update.md:

After complete: clear step_confirmed and tests_run to false on the scoped develop session (SESSION.md after-step rules).

4. Context checkpoint

After the step, follow context-management.mdc and references/context-management.md. At >= 40%, save plan + docs and pause - do not start the next plan step in the same session.

5. Report

Files written, step completed, progress N/M, suggested handoff. Manual validation: references/validation.md. Optional commit: references/optional-commit.md.

Must not

• Run without docs/documentation-plan/plan.md (unless user gives an explicit alternate plan path)
• Use flat {repo-hash}.json for step_confirmed / tests_run when the doc plan path is known - always PLAN-scoped develop session
• Assume MES/Athena or fixed stack versions
• Write product docs/ before doc language is known
• Complete multiple plan steps in one session when context is high - prefer one step per session
• Require external wiki or work-item APIs

Handoff