guardian-tracker

Guardian Tracker — Auto-Track Skill

Purpose

Manually tracking every change is tedious. This skill automates it. After every significant operation, it analyzes what changed and records it to memory.db via Project-Guardian MCP tools.

When to Load

• After file edits or creates
• After git commits
• After bug fixes
• After refactoring
• After architectural decisions
• At end of significant work blocks

Core Workflow

After File Edit/Create

1. Identify what changed (new file? modified? which functions?)
2. Check if file entity exists:

   search_nodes query="file:<path>"
   

3. Create a missing file entity with create_entity; update an existing one with add_observation:

    add_observation observations=[{
      "entityName": "file:<path>",
      "contents": ["[<timestamp>] action: edit | changes: <summary> | lines: +/-<count>"]
   }]
   

4. Link to relevant features/tasks:

   create_relation relations=[{
     "from": "file:<path>",
     "to": "feature:<name>",
     "relationType": "implements"
   }]
   

After Git Commit

1. Run the bundled tracker to obtain machine-readable changed and untracked paths
2. Create/update entities for each changed file
3. Create a task observation for the commit:

   add_observation observations=[{
     "entityName": "project:<name>",
     "contents": ["[<timestamp>] commit: <hash> | message: <msg> | files: <count>"]
   }]
   

4. Link changed files to the commit's purpose

After Bug Fix

1. Create bug entity:

   create_entity entities=[{
     "name": "bug:<id>:<slug>",
     "entityType": "bug",
     "observations": [
       "[<timestamp>] reported: <error> | severity: <level>",
       "[<timestamp>] cause: <root cause>",
       "[<timestamp>] fix: <solution> | files: <list>"
     ]
   }]
   

2. Link bug to affected entities:

   create_relation relations=[{
     "from": "bug:<id>:<slug>",
     "to": "task:<id>",
     "relationType": "blocks"
   }]
   

3. After fix, remove blocks relation:

   delete_relation relations=[{
     "from": "bug:<id>:<slug>",
     "to": "task:<id>",
     "relationType": "blocks"
   }]