/log-doc-issues

Run documentation audit and create GitHub issues for all findings.

What This Does

• Invoke /check-docs to audit documentation

• Parse findings by priority (P0-P3)

• Check existing issues to avoid duplicates

• Create GitHub issues for each finding

This is an issue-creator. It creates work items, not fixes. Use /fix-docs to fix issues.

Process

1. Run Primitive

Invoke /check-docs skill to get structured findings.

2. Check Existing Issues

gh issue list --state open --label "domain/docs" --limit 50

3. Create Issues

For each finding:

gh issue create
--title "[P1] README missing Installation section"
--body "$(cat <<'EOF'

Problem

README.md exists but lacks Installation section. New developers cannot set up the project.

Impact

• Contributor onboarding blocked
• Time wasted figuring out setup
• Potential contributors give up

Location

README.md

Suggested Fix

Run /fix-docs or add manually:

• Prerequisites (Node version, etc.)
• Package manager commands
• Environment setup steps

Created by /log-doc-issues EOF )"
--label "priority/p1,domain/docs,type/chore"

4. Issue Format

Title: [P{0-3}] Documentation gap description

Labels:

• priority/p0 | priority/p1 | priority/p2 | priority/p3

• domain/docs

• type/chore

Body:

Problem

What documentation is missing or broken

Impact

Who is affected (new devs, users, contributors)

Location

File path or expected file location

Suggested Fix

Skill to run or manual action

Created by /log-doc-issues

Priority Mapping

Gap Priority

Missing README.md P0

Missing .env.example (with env vars used) P0

README missing key sections P1

Undocumented env vars P1

Missing architecture docs P1

Stale documentation (90+ days) P2

Missing CONTRIBUTING.md P2

Missing ADR directory P2

Broken links P2

Polish improvements P3

Output

After running:

Documentation Issues Created:

• P0: 0
• P1: 3 (README sections, env vars)
• P2: 2 (stale docs, ADRs)
• P3: 1 (link checking)

Total: 6 issues created View: gh issue list --label domain/docs

Related

• /check-docs

• The primitive (audit only)

• /fix-docs

• Fix documentation gaps

• /documentation

• Full documentation workflow

• /groom

• Full backlog grooming