Skip to main content

Session: [Topic Name]

Date: YYYY-MM-DD Agent: [Agent name/type - e.g., Claude Code, LM Studio model, Human] Duration: [Time spent - e.g., 2 hours] Status: [In Progress / Completed / Blocked]

📋 Objective​

[Clear statement of what this session aimed to accomplish]

Example:

Migrate React llm components to theia extension architecture

🎯 Context​

Prerequisites​

  • [What was needed before starting]
  • [Dependencies or prior work]

Background​

[Relevant background information, links to docs, ADRs, etc.]

Starting State​

[Description of the codebase/system state at session start]

✅ Work Completed​

Summary​

[High-level summary of accomplishments]

Detailed Tasks​

  • Task 1 - Details
  • Task 2 - Details
  • Task 3 - Details
  • Task 4 - Incomplete (if applicable)

Metrics​

  • Files Created: X
  • Files Modified: Y
  • Tests Added: Z
  • Documentation Updated: [Yes/No]

🚧 Challenges & Solutions​

Challenge 1: [Title]​

Problem: [Description of the issue] Solution: [How it was resolved] Lessons Learned: [Key takeaways]

Challenge 2: [Title]​

Problem: [Description] Solution: [Resolution] Lessons Learned: [Takeaways]

📁 Artifacts Created​

Code Files​

  • Created:

    • /path/to/file1.ts - Purpose and description
    • /path/to/file2.tsx - Purpose and description

  • Modified:

    • /path/to/file3.ts - What changed and why
    • /path/to/file4.tsx - What changed and why

  • Deleted:

    • /path/to/old-file.ts - Reason for deletion

Documentation​

  • DOCUMENT.md - Purpose
  • README.md - Updates made

Tests​

  • test-file.spec.ts - What it tests

🎯 Decisions Made​

Architecture Decisions​

  1. Decision: [What was decided]

    • Rationale: [Why]
    • Alternatives Considered: [Other options]
    • Trade-offs: [What was gained/lost]

  2. Decision: [What was decided]

    • Rationale: [Why]
    • Alternatives Considered: [Other options]
    • Trade-offs: [What was gained/lost]

Technical Choices​

  1. Choice: [Technology/approach chosen]

    • Reason: [Why this was the best option]
    • Impact: [Effect on the project]

  2. Choice: [Technology/approach chosen]

    • Reason: [Why]
    • Impact: [Effect]

🐛 Issues & Blockers​

Active Blockers​

  1. Blocker: [Description]

    • Impact: [What it prevents]
    • Potential Solution: [Ideas for resolution]
    • Owner: [Who should resolve]

  2. Blocker: [Description]

    • Impact: [What it prevents]
    • Potential Solution: [Ideas]
    • Owner: [Who should resolve]

Resolved Issues​

  1. Issue: [What the problem was]
    • Resolution: [How it was fixed]
    • Prevention: [How to avoid in future]

🔄 Next Steps​

Immediate Actions (Today/Tomorrow)​

  1. [Action 1] - Priority: High/Medium/Low
  2. [Action 2] - Priority: High/Medium/Low
  3. [Action 3] - Priority: High/Medium/Low

Short-term (This Week)​

  1. [Action 1]
  2. [Action 2]
  3. [Action 3]

Long-term (This Month)​

  1. [Action 1]
  2. [Action 2]
  3. [Action 3]

📊 Related Work​

Project Plan Tasks​

  • ✅ Phase X.Y: [Task name] (completed this session)
  • ✅ Phase X.Z: [Task name] (completed this session)
  • 🚧 Phase Y.A: [Task name] (in progress)
  • 🔲 Phase Y.B: [Task name] (next up)

Reference: project-tasks/project-plan-with-checkboxes.md

  • [Link to previous session]
  • [Link to related session]

ADRs Referenced​

  • ADR-XXX: [Decision title]
  • ADR-YYY: [Decision title]

💡 Insights & Learnings​

What Worked Well​

  1. [Successful approach/technique]
  2. [Helpful tool/method]
  3. [Effective workflow]

What Could Be Improved​

  1. [Area for improvement]
  2. [Process that needs refinement]
  3. [Skill to develop]

Key Takeaways​

  1. [Important lesson learned]
  2. [Pattern to remember]
  3. [Principle to apply in future]

🧪 Testing & Validation​

Tests Run​

  • Unit tests pass
  • Integration tests pass
  • E2E tests pass
  • Manual testing completed

Validation Checklist​

  • Code compiles without errors
  • TypeScript type check passes
  • Linting passes
  • Documentation updated
  • Git commit created

📝 Notes & Comments​

Technical Notes​

[Any technical details worth documenting]

References​

  • [Link to documentation]
  • [Link to example code]
  • [Link to relevant issue/PR]

Open Questions​

  1. [Question that needs answering]
  2. [Uncertainty to resolve]
  3. [Area needing clarification]

🚀 Handoff Information​

For Next Agent/Developer​

Context Summary: [1-2 sentence summary for quick orientation]

Quick Start:

# Commands to get up to speed
cd /workspace/PROJECTS/t2
npm install
npm run theia:build

Key Files to Review:

  1. /path/to/important/file.ts - Why important
  2. /path/to/another/file.tsx - Why important

Watch Out For:

  • [Gotcha 1]
  • [Gotcha 2]
  • [Known issue to be aware of]

Session End Time: [Timestamp] Next Session Scheduled: [Date/Time or "TBD"]