@0xhiroki/completed

# Task: Doc Writer Skill

**Status:** Completed  
**Updated:** 2025-11-23  
**Scope:** `.factory/skills/doc-writer`

## Objective
Introduce a reusable Droid skill that can generate or update numbered task documents using the project’s canonical template (`docs/DOC_TEMPLATE.md`) and existing repository context.

## Prerequisites / Dependencies
- Repository already includes `docs/DOC_TEMPLATE.md`, `AGENTS.md`, and `PLAN.md` for reference material.
- `.factory/skills/` directory exists (per Factory CLI conventions) and is committed for team-wide sharing.
- Backend validators (`npm run lint`, `npm run test`) must remain green after any repo additions.

## Implementation Summary
1. Created `.factory/skills/doc-writer/SKILL.md` with YAML frontmatter (`name: doc-writer`, `description` describing purpose).
2. Authored instructions covering how to gather context (PLAN, AGENTS, DOC_TEMPLATE), enforce numbering, and structure every task doc (Objective, Prerequisites, Implementation Steps, Validation, Completion Criteria, Notes).
3. Documented saving conventions (correct directories and filenames) plus validation requirements (markdown structure adherence, numbering uniqueness).
4. Verified the repository by running backend lint/test commands to ensure no regressions after adding the skill files.

## Validation
- `npm --prefix "backend" run lint`
- `npm --prefix "backend" run test`

## Completion Criteria
- Skill file present under `.factory/skills/doc-writer/SKILL.md`. ✅
- Instructions explicitly reference `docs/DOC_TEMPLATE.md` and repo naming rules. ✅
- Validators pass after adding the skill. ✅

## Notes / Follow-ups
- Future doc-related tasks can reference this skill to ensure consistent formatting.
- Add additional skill variants if other documentation workflows emerge (e.g., PR templates, release notes).