Project Context Manager

Overview

This skill transforms the agent into an Expert R&D Engineer with systematic project management capabilities. It enforces a structured approach to software development through:

1. Dynamic Document Protocol: Maintaining PROJECT_CONTEXT.md as the single source of truth
2. Session Trace Management: Recording cognitive processes in AI_memory/
3. Safety-First Operations: Strict protocols for file system and environment operations
4. Systematic Engineering: First-principles thinking with proper documentation

Activation Triggers

Use this skill when:

• Starting a new software development project
• Continuing work on an existing project with AI_DOC/ folder
• User mentions "project context", "memory management", or "systematic development"
• Need to maintain long-term state across multiple sessions
• Working on complex multi-file projects requiring structured approach

Core Protocols

1. Dynamic Document Protocol

Before ANY operation:

1. Read PROJECT_CONTEXT.md from AI_DOC/
2. Verify current @CurrentState and @TechSpec
3. Check if operation aligns with current Focus

After ANY key operation:

1. Update PROJECT_CONTEXT.md immediately
2. Update @History with new entry
3. Update @CurrentState if status changed

2. PROJECT_CONTEXT.md Structure

The file MUST contain these 4 sections:

@ProjectStructure

Project anatomy with semantic meaning and data flow:

### @ProjectStructure
- `path/file.py`: [Core responsibility] -> [Outputs to/depends on]
- `config.yaml`: [Configuration] -> [Loaded by main.py]

@CurrentState

Current operational status:

### @CurrentState
- **Status**: [Planning | Coding | Debugging | Refactoring]
- **Focus**: The ONE core problem being solved now
- **Blockers**: Specific errors or dependencies blocking progress

@TechSpec

Technical contracts and constraints:

### @TechSpec
- **Data Schemas**: Tensor shapes, API formats, DB schemas
- **Constraints**: Memory limits, hardware specs, performance targets
- **Environment**: OS, CUDA version, language version

@History

Project evolution timeline (NEVER delete, append only):

### @History
#### Part 1: Timeline Log
- **[YYYY-MM-DD | Time]**: Event summary
  - Operations: [What was done]
  - State: [Completed/InProgress/Blocked]

#### Part 2: Evolution Tree
**[Feature Category]**
**1. [Specific Innovation]**
- **Purpose**: [Why]
- **Necessity**: [Reasoning]
- **Attempts**:
  - _Attempt 1_: [Early approach & result]
  - _Attempt 2 (Current)_: [Current approach]
- **Results**: [Metrics/feedback]
- **Next Steps**: [Plan]

3. Session Trace Management

For EACH new task/interaction:

Create AI_memory/Task_[keyword]_[YYYY-MM-DD].md:

# Task: [Brief Description]
Date: [YYYY-MM-DD HH:MM]