ensure-tracking

name	ensure-tracking
description	Verify and complete all documentation for the current PRP phase before closing context, so the next session can continue seamlessly.
argument-hint	<prp-folder>
disable-model-invocation	true

Ensure Tracking

PRP Folder: $ARGUMENTS

Verify and complete all documentation for the current phase before closing context. Run this when you feel the agent hasn't properly documented everything.

Purpose: Ensure the next agent session has complete context to continue seamlessly.

---

STEP 1: IDENTIFY CURRENT PHASE

Read {$ARGUMENTS}/_STATUS.md to find:

• Current phase number and name
• Current phase folder path

---

STEP 2: AUDIT COMPLETED.md

Read {current-phase}/COMPLETED.md and verify it contains:

Required Sections (Must Be Filled)

• Date Started - When work began
• Date Completed - When tasks finished (or "In Progress")
• Summary - What was accomplished (1-2 paragraphs)

Changes Made (Must Be Complete)

• Data Model Changes - All migration/schema files created with descriptions
• Files Created - Every new file with its purpose
• Files Modified - Every modified file with line numbers and what changed
• Types/Interfaces Added - Code snippets of new types

Testing Instructions

• How to Test - Step-by-step instructions for manual testing

If Any Section is Missing or Incomplete:

Fill it in now by reviewing:

1. Git diff or recent changes
2. The tasks from PLAN.md
3. Your memory of what was done

---

STEP 3: AUDIT FIXES.md

Read {current-phase}/FIXES.md and verify:

For Each Fix Reported:

• Issue Title - Clear description
• User Feedback - Exact quote of what user reported
• Status - Must be "Fixed" (not "Pending" or "In Progress")
• Root Cause - Why the issue happened
• Solution - What was done to fix it
• Files Changed - Table with file, lines, and description
• Code Changes - Before/after code snippets

If Any Fix is Incomplete:

Fill it in now with the missing details.

If Status is Still "Pending" or "In Progress":

Either fix the issue or document why it wasn't fixed.

---

STEP 4: AUDIT HANDOFF.md

Read {current-phase}/HANDOFF.md and verify:

Required Sections (Must Be Filled)

• Phase Status - Must say "Complete and Verified"
• Handoff Date - Today's date
• What Was Built - 1-2 paragraph summary
• Key Implementation Details - Important technical details
• Decisions Made - Table of decisions and reasoning
• Files Summary - Lists of added and modified files
• Data Model State - New tables, columns, functions
• Known Issues / Tech Debt - List or "None"
• Fixes Applied - Summary of fixes from FIXES.md
• Verification Checklist - All boxes checked
• Next Phase - Name and path to next phase
• Context for Next Phase - What the next agent needs to know

If Any Section is Missing or Empty:

Fill it in now.

---

STEP 5: AUDIT _STATUS.md

Read {$ARGUMENTS}/_STATUS.md and verify:

• Current Phase - Points to the NEXT phase (not the one just completed)
• Status - Should be "Not Started" for next phase
• Quick Status - Completed phase shows Complete, next phase shows Not Started
• Last Updated - Today's date with note about what changed

If Not Updated:

Update it now to reflect phase completion.

---

STEP 5.5: AUDIT KNOWLEDGE BASE & PROJECT DOCS

Check if knowledge base AND project documentation were updated for this phase.

5.5.1 Determine if Updates are Required

KB and project doc updates are REQUIRED for EVERY phase (not just final phase):

• Knowledge can be lost between sessions
• Patterns established early should be documented immediately
• Gotchas discovered should be captured right away

Skip only if: Phase was purely bug fixes with no new patterns or decisions.

5.5.2 Audit Knowledge Base

Verify:

• At least one topic file in knowledge-base/ references this PRP in **Source PRPs:**
• The topic file's ## Changes Log has an entry with today's date (or recent date)
• The affected section's _SUMMARY.md reflects the topic
• knowledge-base/INDEX.md is up to date

5.5.3 Audit Project Documentation

Verify the project's root documentation was updated:

AGENTS.md (durable facts only):

• New code patterns from this phase are documented (only if they're durable, every-session conventions)
• New file organization or module responsibilities are noted (only if structural)
• New commands or utilities are listed (build/test/lint/dev)
• Anti-patterns discovered are documented as "always do X / never do Y" rules
• Architecture or data-flow changes are reflected in the high-level map
• Fix logs, changelogs, per-feature narratives, and transient status are NOT present (those belong in FIXES.md/COMPLETED.md and the knowledge base)

5.5.4 If Updates are Missing

Flag as issues:

• "Knowledge base not updated for phase {N}" → run /update-knowledge-base {PRP path}
• "AGENTS.md not updated with durable facts (if any)"

Offer to run the documentation update now using /update-knowledge-base {PRP path}

5.5.5 Add to Tracking Report Output:

KNOWLEDGE BASE:
  Topic updated: {topic-name} in {section}
  Changes log entry added
  Summary regenerated
  Index up to date

PROJECT DOCUMENTATION:
  AGENTS.md: Updated with {what} (durable facts only)

Or if missing:

KNOWLEDGE BASE:
  No topic references this PRP — run /update-knowledge-base {PRP path}

PROJECT DOCUMENTATION:
  AGENTS.md: Missing durable facts from this phase (if any)

---

STEP 6: CROSS-CHECK CONSISTENCY

Verify consistency across all files:

1. Files mentioned in COMPLETED.md should match files in HANDOFF.md
2. Fixes in FIXES.md should be summarized in HANDOFF.md
3. Phase status in _STATUS.md should match HANDOFF.md verification
4. Next phase in HANDOFF.md should match current phase in _STATUS.md

If Inconsistencies Found:

Fix them now to ensure single source of truth.

---

STEP 7: GENERATE TRACKING REPORT

After completing the audit, output:

========================================
TRACKING AUDIT COMPLETE
========================================

Phase: {N} - {Phase Name}
PRP: {$ARGUMENTS}

COMPLETED.md:
  Summary filled
  Data model changes documented
  Files created listed
  Files modified listed
  Testing instructions provided

FIXES.md:
  {N} fixes documented
  All fixes resolved (no pending)
  Code changes included

HANDOFF.md:
  What was built summary
  Implementation details
  Decisions documented
  Files summary complete
  Next phase context provided

_STATUS.md:
  Points to Phase {N+1}
  Quick status updated
  Last updated set

Knowledge Base:
  Topic(s) updated
  Index regenerated

Project Docs:
  AGENTS.md updated with durable facts (or "No changes needed")

Consistency:
  Files match across documents
  Fixes summarized in handoff
  Status aligned

========================================
READY TO CLOSE CONTEXT

Next session: /continue-prp {$ARGUMENTS}
========================================

If Issues Were Found and Fixed:

========================================
TRACKING AUDIT COMPLETE (WITH FIXES)
========================================

Issues Found and Fixed:
- COMPLETED.md: Added missing files modified section
- FIXES.md: Added code changes for Fix #2
- HANDOFF.md: Added context for next phase
- _STATUS.md: Updated to point to Phase 2

========================================
NOW READY TO CLOSE CONTEXT

Next session: /continue-prp {$ARGUMENTS}
========================================

---

QUICK CHECKLIST

Before closing context, all must be true:

COMPLETED.md

• Has summary of what was done
• Lists all files created
• Lists all files modified with changes
• Has testing instructions

FIXES.md

• All fixes have "Fixed" status
• Each fix has root cause and solution
• Code changes are documented

HANDOFF.md

• Summary of phase accomplishments
• All decisions documented
• Files summary matches COMPLETED.md
• Context for next phase is clear
• Verification checklist complete

_STATUS.md

• Points to next phase
• Completed phase marked complete
• Last updated is today

Knowledge Base

• At least one topic references this PRP
• Index and summaries are up to date

Project Docs

• AGENTS.md has durable, every-session facts documented (if any)

---

CRITICAL REMINDER

The next agent will ONLY have access to these files.

They will NOT have:

• Your memory of what happened
• The chat history
• Context about why decisions were made

Everything must be written down. If it's not documented, it didn't happen.