Add --focus mode to document-this for feature-scoped doc subfolders

[stephenfinch]

Summary

Ports document-this improvements developed in a consuming project back into the shared skills repo so other projects can use them.

/document-this --focus "<Feature Name>" now generates a self-contained deep-dive subfolder for a single feature/subsystem:

generated-docs/
└── <slug>/                          # kebab-case slug of the feature name
    ├── workflows.md                 # feature-scoped, grouped by audience
    ├── architecture.md              # feature-scoped, tighter than the full template
    └── diagrams/
        ├── <slug>-architecture.mmd
        └── <slug>-data-model.mmd

Changes

• SKILL.md: new focused generation process (Phases F1–F4: feature scoping → scoped workflow discovery → scoped architecture analysis → cross-linking from top-level docs), slug derivation rules, a --focus variant of targeted updates, and focus-mode quality rules (scope discipline, no README/ai-orientation in subfolders, back-links to top-level docs).
• templates/focus-workflows.template.md (new): scaffold for a feature-scoped workflows doc with audience overview and back-links.
• templates/focus-architecture.template.md (new): scaffold for a feature-scoped architecture doc.
• templates/README.template.md: optional {{FOCUS_SUBFOLDERS}} "Deep dives" block so the top-level README links to any focus subfolders.
• AGENTS.md: updated the document-this summary to mention --focus.

Scripts are unchanged.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Adds a new --focus "<Feature Name>" mode to the document-this skill so agents can generate feature-scoped “deep dive” documentation subfolders under generated-docs/<slug>/, and optionally link them from the top-level docs.

Changes:

• Extends document-this skill instructions to define a focused generation process (Phases F1–F4), slug rules, and a --focus targeted-update flow.
• Adds new focus-mode templates for feature-scoped workflows.md and architecture.md.
• Updates the top-level README template (and AGENTS.md summary) to mention/link focus subfolders.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
skills/document-this/templates/README.template.md	Adds an optional “Deep dives” section for linking focus-mode subfolders and updates regeneration instructions.
skills/document-this/templates/focus-workflows.template.md	New template scaffold for feature-scoped workflows documentation.
skills/document-this/templates/focus-architecture.template.md	New template scaffold for feature-scoped architecture documentation and diagrams.
skills/document-this/SKILL.md	Documents --focus invocation, output structure, slug rules, phased process, and targeted-update behavior.
AGENTS.md	Updates the document-this summary to mention --focus.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.