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

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

This testing preview is a major update from v1.0.0-test-7, with a comprehensive internal redesign of artifact naming, Memory architecture, file path conventions, and cross-file standards compliance. Every template file has been touched.

Compared to the previous preview, this release focuses on making APM's internal system cleaner and more predictable: shorter artifact names, structured YAML schemas, kebab-case paths, and a clearer separation between live coordination state and durable project memory.

What improves for users (high impact)

  • Simpler, shorter artifact names throughout

    • Specifications → Spec, Implementation Plan → Plan, Execution Standards → Rules. Better UX. Simpler and minimalist terminology creating a cleaner APM ecosystem.
  • Cleaner file system layout

    • All .apm/ paths are now kebab-case with zero-padded numbers. Files like Implementation_Plan.md and Memory/Memory_Root.md become plan.md and tracker.md. Log files use .log.md suffix for clear identification: .apm/memory/stage-01/task-01-02.log.md.
  • Memory architecture split: Tracker + Index

    • The old Memory Root has been split into two purpose-built documents. The Tracker (tracker.md) holds live project state — task tracking, agent tracking, VC state, and ephemeral working notes. The Index (memory/index.md) holds durable project memory — persistent observations, patterns, and stage summaries that survive Handoffs.
  • Bus files simplified

    • apm-task.md → task.md, apm-report.md → report.md, apm-handoff.md → handoff.md. The apm- prefix was redundant inside the .apm/bus/ directory.
  • Structured YAML frontmatter with field descriptions

    • Task Prompts, Task Logs, Handoff Logs, and batch envelopes now have documented YAML schemas with concrete examples and per-field descriptions. agent_id → agent, memory_log_path → log_path, task_id replaced by stage/task/title fields.

What improves for agents (behavioral)

  • Communication protocol elevated to skill

    • Agent-to-user communication, visible reasoning, and terminology boundaries are now consolidated in the communication skill as the single source of truth. Guides no longer duplicate these instructions — they cross-reference instead.
  • Formal note-taking system

    • New §2.6 in the Task Review guide distinguishes ephemeral Working Notes (coordination context in the Tracker, inserted and removed as needed) from durable Memory Notes (lasting patterns and insights in the Index).
  • Manager Handoff prompts expanded for outstanding Tasks

    • The outgoing Manager now describes outstanding Tasks with enough detail for the incoming Manager to coordinate and review — objectives, instructions, review criteria, dependency context, workspace information. This is defensive: the clear-on-return protocol means Workers may have already cleared their Task Bus, so the original Task Prompt is gone by Handoff time. The incoming Manager needs the substance of what was dispatched, not just pointers.
  • Handoff Logs restructured with proper YAML schemas

    • Both Manager and Worker Handoff Logs now use structured YAML frontmatter (agent, outgoing_session, incoming_session, handoff, stage) with documented field descriptions and reorganized body sections.
  • Standards compliance across all files

    • 60+ compliance findings from a systematic audit have been addressed: reference format standardization, procedure transition naturalization, terminology consistency, formatting fixes, de-duplication, and cross-file behavioral alignment.

Main changes

Artifact templates (new file layout)

  • Deleted: Implementation_Plan.md, Specifications.md, Memory/Memory_Root.md
  • Added: plan.md, spec.md, tracker.md, memory/index.md — all with YAML frontmatter

Standards

  • WORKFLOW.md: full rewrite of §5 Memory for Tracker/Index architecture, all term renames, bus file name updates, context rebuilding order updated, bus initialization moved from Manager to Planner
  • TERMINOLOGY.md: all term definitions and file locations updated
  • STRUCTURE.md: new §8.4 APM Artifact Files, §8.5 Task Identifiers (N.M prose, integer YAML, zero-padded paths)
  • WRITING.md: procedure transition example updated

Commands (all 7 updated)

  • All artifact references, bus file paths, and YAML field names updated
  • apm-1: bus initialization moved here as §4 Planning Phase Completion
  • apm-2: session detection changed from Handoff Bus to Tracker template state, Manager session 1 now populates both Tracker and Index
  • apm-6, apm-7: Handoff Log YAML schemas with field descriptions, restructured body sections, eligibility gates removed

Guides (all 6 updated)

  • task-review.md: new §2.6 Note-Taking Standards, restructured Tracker/Index format specs, stage summaries moved to Index
  • task-logging.md: Task Log YAML schema restructured (stage/task/title fields), Next Steps section removed, kebab-case paths
  • task-assignment.md: YAML schema with concrete examples and field descriptions, Spec Extraction standards
  • work-breakdown.md: restructured from 6 flat steps to 3 artifact-aligned sections, YAML frontmatter-based header procedures
  • All guides: communication/reasoning standards consolidated via skill cross-reference

Skills

  • apm-communication: consolidated as single source for agent-to-user communication, all bus file names updated, batch envelope/report schemas with concrete examples and field descriptions
  • bus-integration.md: renamed from apm-bus-integration.md, added Overview section
  • apm-version-control: all artifact references updated, VC entry format simplified

Thanks for testing. Feedback on the new naming, file layout, and Tracker/Index split is especially useful before v1.0.0 stable.

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

NewReleases is sending notifications on new releases.