github sdi2200262/agentic-project-management v1.0.0-test-20
APM Release v1.0.0-test-20

latest releases: v1.2.0-test-5, v1.2.0-test-4, v1.2.0-test-3...
pre-release7 months ago

Worker init redesign, bus protocol reliability, debugging delegation, worktree isolation, Handoff continuity, Planner decomposition reasoning, and Codex CLI platform support.

Template Changes

  • Worker init checks bus state on registration — after identity resolution, the Worker inspects both the Task Bus and Handoff Bus to determine the init path. If a Task Prompt is already waiting, execution begins immediately without requiring /apm-4-check-tasks. Mid-Task and mid-batch Handoffs are detected from the same bus check, with the handoff prompt describing per-Task completion state. Eliminates one round-trip on every first dispatch and fixes the mid-batch Handoff gap where incoming Workers had to re-read and manually skip completed Tasks.

  • Bus read-before-write at procedure points — the bus protocol rule (read before writing) was in the communication skill but not reinforced at the actual write steps in task-assignment and task-logging. Agents violated it consistently, caught only by platform tool enforcement. Each bus write step now explicitly reads first. Bus lifecycle clarified: directories are initialized during the Planning Phase and not re-created by later agents.

  • Debug subagent as second step, not last resort — when a Worker's initial fix attempt doesn't resolve the issue, the next step is spawning a debug subagent with full accumulated context rather than continuing to iterate in the main context. Extended debugging loops consumed massive context across multiple instances in testing. When independent root causes are plausible, separate subagents examine each in parallel.

  • Workspace discovery ordering — the prohibition on deep codebase exploration before reading the Context Gathering guide was buried mid-sentence. Promoted to a standalone directive: no source code reads, no subagent dispatches during the light workspace scan.

  • Worktree standards tightened — every parallel dispatch unit gets its own worktree (eliminates asymmetric proposals where one Worker stays in the main directory). .apm/ path resolution clarified for worktree dispatch: Workers perform code work in the worktree but resolve all .apm/ paths from the project root. When .apm/ is tracked in git, runtime operations still target the project root so the Manager can read logs before merging. Worktree cleanup ordering made explicit with rationale.

  • Handoff artifact distinction — continuation guidance moved from the Handoff Log (past-tense record) to the Handoff Prompt (actionable state). Previous-Stage log reporting is now conditional on previous Stages existing, eliminating spurious statements in Stage 1. Manager Handoff detection updated to not require the Previous-Stage note when it doesn't apply.

  • Task guidance references Spec — Plan Task guidance can reference Spec sections for shared design decisions instead of restating them. The Manager resolves these references during Task Prompt construction. Reduces duplication between Spec and Plan without losing content.

  • Planner notes redesigned — blockquote notes generalized from section-specific placement (Workspace, Dependency Graph) to a general mechanism after the document header separator. Spec notes cover project environment, User preferences, and coordination context. Plan notes cover work structure, dependency characteristics, and decomposition rationale.

  • Stage Analysis derives Task structure — the Stage Analysis reasoning step now requires visible derivation of how Stage objectives decompose into Tasks, rather than presenting Tasks as predetermined. Stages are explicitly sequential with parallelism structured as parallel Tasks within a Stage.

  • Worker scope constraint — Workers do not reason about or report on project structure beyond their assigned Tasks unless explicitly referenced in the Task Prompt.

  • Validation and terminology — understanding summary added as a defined concept in TERMINOLOGY.md. Context Gathering awareness now covers per-Task validation (preventing misleading questions about validation frameworks). Guide-label leak reinforcement in the Context Gathering procedure intro.

  • Per-standard audit — broken cross-references fixed (§4.2 Worktree Directory Layout, §5.1 Identity Scope), double-colon violations corrected, spacing and passive voice fixes, terminology capitalization corrections.

Build Changes

  • Codex CLI added as 6th platform target — commands output as Codex skills (.codex/skills/<name>/SKILL.md with transformed frontmatter), agents output as TOML with developer_instructions, explorer subagent type. Codex CLI does not support custom slash commands — APM commands are invoked with the $ prefix instead of /.

  • Cursor argument handling fixed — Cursor lacks $ARGUMENTS support in custom commands. Both Cursor and Codex now use descriptive text so the model picks up User input naturally.

Repository Changes

  • Dependencies pinned, unused js-yaml restored (build pipeline dependency).

Don't miss a new agentic-project-management release

NewReleases is sending notifications on new releases.