Agent-Skills.md

Agent Skills: Project Planning

|

UncategorizedID: zenobi-us/dotfiles/project-planning

Repository

zenobi-us/dotfiles
zenobi-usLicense: MIT
676

Install this agent skill to your local

pnpm dlx add-skill https://github.com/zenobi-us/dotfiles/tree/HEAD/devtools/files/pi/agent/bundles/business/skills/projectmanagement/project-planning

Skill Files

Browse the full folder contents for project-planning.

Download Skill

Loading file tree…

devtools/files/pi/agent/bundles/business/skills/projectmanagement/project-planning/SKILL.md

Skill Metadata

Name
project-planning
Description
|

Project Planning

Rule Zero

This skill presents a router to the agent for following the project planning workflow. It provides guidance on artifact types, workflow phases, estimation techniques, relationships, and status transitions.

The user will invoke the agent to use this skill in various scenarios, so there are two main steps to follow:

  1. Detecting the storage system for the current CWD.
  2. Lazy loading only the relevant resources when needed based on the current workflow phase and artifact type.

Detecting Storage System

When the agent is invoked, it should first determine the storage system in use for the current CWD or request.

  1. Look in these places for this information in order:
    • There might be a $PROJECT_PLANNING_STORAGE_SYSTEM environment variable defined that indicates the storage system. If so, use that information.
    • The AGENTS.md might have already described the storage system for this agent. If so, use that information.
    • The user might have specified the storage system in their request or in the context of the conversation. If so, use that information.
  2. Qualify the storage system defined. It might not exist. Only valid storage systems defined in ./references/storage-systems are valid. If the storage system is invalid, respond with an error message indicating that the storage system is not supported and provide a list of valid storage systems.

Wrapper Path Resolution

For this skill, any referenced ./scripts/storage-system/... path is relative to this skill bundle, not the target project directory.

Agents MUST NOT create project-local wrapper files unless a storage backend document explicitly requires project scaffolding.

Planning Artifacts

  1. Before using any concept here you MUST detect a StorageSystem strategy from one of the available backend references for the project you are operating in. If no strategy is detected, you MUST escalate to Q and stop before execution.
  2. You MUST follow the defined artifact types, workflow phases, and relationships when creating and managing planning artifacts.
  3. You MUST adhere to the filename conventions for all artifact files and links.
  4. You MUST use the provided schemas for each artifact type to ensure consistency and completeness of information
  5. You MUST escalate to Q for any strategic decisions, scope changes, timeline shifts, major refactors, or resource constraints that arise during planning.

Planning Artifact Types

Every project planning file must be one of the following:

A project MUST have exactly one project-level constitution before planning exits. It is a singleton governing artifact, not an ID-bearing work item.

  • Project Constitution: singleton project-level governing artifact defining overall goals, principles, constraints, guidelines, and decision authority. Exactly one MUST exist per project before planning exits.
  • Idea: low-commitment opportunity framing; may promote to Epic.
  • Epic: committed direction with phase planning sections.
  • Story: phase-agnostic requirement (WHAT) with acceptance criteria and test spec.
  • Task: scheduled implementation work (WHEN) with required phase_id; links to story when applicable.
  • Research: structured discovery feeding decisions and scope.
  • Decision: explicit choice with rationale and trade-offs.
  • Learning: distilled reusable knowledge.
  • Retrospective: closeout review; MUST include unresolved decision review.

Filename Conventions

See: Filename Conventions

Storage System

You MUST select one storage backend before execution:

If the selected backend document is still a TODO/stub, the agent MUST escalate to Q and stop before execution.

Planning Artifact Relationships

See: Relationships

Process Principles

Workflow Phases

Depending on the artifact type you're working with, you may need to execute different workflow phases. The core workflow includes:

  1. Initialization — Setup Storage System with necessary templates and structure (The storage system instructions will define how to do this for each backend)

  2. Planning — define artifacts and links

  3. Execution — advance work through status transitions

  4. Closing — reconcile artifacts and prepare closeout

  5. Retrospective — capture lessons and follow-ups

See complete model: Workflow Overview

Status Transitions

See: Status Flow

Escalation

Escalate strategic decisions to Q: scope changes, timeline shifts, major refactors, resource constraints.

Estimation

See: Estimations