generate-spec-docs

This Skill automatically generates Japanese documentation by processing English spec files in the specs/ directory. It creates three role-based documents per feature—overview.ja.md for PMs, architecture.ja.md for architects, and implementation.ja.md for developers—preserving the English source and regenerating on every spec change.

This Skill is specifically designed for Japanese documentation generation from English specs. It produces Japanese-language output only and does not support other target languages.

Place spec files under specs/ with the naming pattern specs/feature-name/spec.md. The Skill automatically excludes specs/**/docs/ directories to prevent regeneration loops, and outputs three .ja.md files alongside your source spec.

The Skill deliberately excludes the docs/ subdirectory within specs/ from processing. This prevents it from re-triggering on its own generated output, ensuring stable, single-pass documentation generation on spec edits.

The original English spec file is always preserved. Generated Japanese documentation is output as separate .ja.md files, leaving your source spec unchanged with a timestamp and source reference included.

Documentation regenerates automatically after every spec file change. The Skill activates on spec edits and produces fresh Japanese documents each time, maintaining current alignment with your English specifications.