apm-1-initiate-planner

Gathers project requirements and produces Spec, Plan, and Rules documents for APM sessions.

1|Updated Dec 13, 2025
One-click install
npx skills add https://github.com/ZK-Theory/TDL --skill apm-1-initiate-planner-zk-theory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apm-1-initiate-planner
Source: https://github.com/ZK-Theory/TDL/tree/main/.agents/skills/apm-1-initiate-planner
Command: npx skills add https://github.com/ZK-Theory/TDL --skill apm-1-initiate-planner-zk-theory

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a multi-agent project without structured requirements leads to misaligned execution. This Skill runs the APM Planner role, guiding requirement gathering and producing the three planning documents (Spec, Plan, Rules) that Manager and Worker agents use to execute the project. ## Core Features & Use Cases - Workspace Discovery: Scans the workspace for PRDs, specifications, archives, and existing AGENTS.md, then confirms with the user which materials are authoritative before proceeding. - Guided Context Gathering: Executes iterative question rounds with gap assessments and a user-approved understanding summary via the context-gathering guide. - Work Breakdown & Document Generation: Populates Spec, Plan, and Rules templates in the .apm/ directory with user approval checkpoints, then initializes the Message Bus directories for all defined Workers and the Manager. - Use Case: A user starting a new feature project invokes the Planner, answers structured discovery questions, approves the generated Spec and Plan, and then hands off to the Manager agent for implementation. ## Quick Start Invoke the apm-1-initiate-planner skill with a short description of your project to begin requirement gathering and planning document creation.

Frequently Asked Questions about apm-1-initiate-planner

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

FAQPage Schema
How do I start an APM planning session?

Invoke the apm-1-initiate-planner skill, optionally with project context text. The Planner greets you, scans the workspace for authoritative materials, then runs context gathering and work breakdown to produce the Spec, Plan, and Rules documents.

What documents does the APM Planner create?

The Planner produces three planning documents: a Spec, a Plan, and Rules (written to AGENTS.md). It also initializes the Message Bus under .apm/bus/ with task, report, and handoff files for each Worker and the Manager.

Can I provide project context upfront to the APM Planner?

Yes, text provided after the command invocation is treated as front-loaded context that establishes authoritative materials and focuses discovery. Context Gathering still runs regardless of how much context is supplied.

What happens after the APM planning phase completes?

After all planning documents are approved and the Message Bus is initialized, the Planner directs you to start the Implementation Phase by initiating the Manager with /apm-2-initiate-manager in a new chat.

Does the APM Planner explore the codebase automatically?

Deep codebase exploration is controlled by the context-gathering guide, not the initial scan. The Planner first does a light workspace scan, confirms authoritative materials with you, then follows the guide's exploration standards.