mj-agent-doc-plan

Evaluates documentation needs for mj-agent changes and outputs a 10-row decision matrix.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/MJ-AgentLab/mj-agent --skill mj-agent-doc-plan-mj-agentlab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mj-agent-doc-plan
Source: https://github.com/MJ-AgentLab/mj-agent/tree/main/.claude/skills/mj-agent-doc-plan
Command: npx skills add https://github.com/MJ-AgentLab/mj-agent --skill mj-agent-doc-plan-mj-agentlab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When planning changes in the mj-agent repository, it is hard to know which of the 10 canonical documentation types (Plan, SPEC, ADR, RUNBOOK, GUIDE, STANDARD, ISSUE, ASSESSMENT, CHANGELOG, INDEX) must be created or updated. This Skill analyzes the diff, Issue, or SPEC scope and produces a complete Documentation Decision matrix so nothing is missed. ## Core Features & Use Cases - Scope Analysis: Reads git diff, GitHub Issue body, and existing docs to identify documented versus missing coverage per mj-agent module, including A/B/C flavor classification. - Type & Track Evaluation: Applies Meta v2.1 type tables and ADR-014 boundary rules to assign each gap a document type and tri-track classification (code, agent, engineering-workflow, shared), with Q-05/Q-12 ambiguity prompts for mixed content. - Dependency-Ordered Task List: Outputs a 10-row §7.1 matrix plus an ordered task list that feeds directly into the mj-agent-flow-plan Stage 4 Plan body. - Use Case: Before starting a multi-module change, ask which documents are needed; the Skill returns the full decision matrix showing what to create, update, or skip, with reasons and evidence. ## Quick Start Ask the agent to evaluate what documentation is needed for the current mj-agent branch changes and produce the §7.1 Documentation Decision matrix.

Frequently Asked Questions about mj-agent-doc-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate what documentation a code change needs?▼

Run this Skill against the current git diff, Issue, or SPEC scope. It scans existing docs per module, identifies gaps, and outputs a 10-row Documentation Decision matrix showing which of the 10 canonical types to create, update, or skip.

What documentation types does the mj-agent decision matrix cover?▼

The matrix covers 10 types: Plan, SPEC, ADR, RUNBOOK, GUIDE, STANDARD, Local ISSUE, ASSESSMENT, CHANGELOG, and INDEX. Each row records the action, target path, reason, evidence, track, and prerequisite dependencies.

How does the skill decide between ADR, SPEC, and RUNBOOK?▼

It applies the Meta v2.1 type table and ADR-014 boundary rules: interface contracts and invariants map to SPEC, architecture decisions and long-term constraints map to ADR, and operational or recovery procedures map to RUNBOOK. Mixed content triggers Q-05 or Q-12 clarification prompts.

When should I not use this documentation planning skill?▼

Do not use it to write a single known document (use mj-agent-doc-author), to author a full Plan body (use mj-agent-flow-plan, which calls this skill as a sub-routine), or to validate an already written document (use mj-agent-doc-validate).

What is the difference between mj-agent-doc-plan and mj-agent-flow-plan?▼

mj-agent-doc-plan only evaluates what documentation is needed and outputs the §7.1 matrix subset. mj-agent-flow-plan authors the complete Stage 4 Plan body and invokes doc-plan as its Step 3 sub-routine for the documentation section.