Agent skill

record-session

Records completed work progress to .trellis/workspace/ journal files after human testing and commit. Captures session summaries, commit hashes, and updates developer index files for future session context. Use when a coding session is complete, after the human has committed code, or to persist session knowledge for future AI sessions.

View SKILL.md on GitHub Repository
Stars 5,124
Forks 287

Install this agent skill to your Project

npx add-skill https://github.com/mindfold-ai/Trellis/tree/main/.agents/skills/record-session

SKILL.md

[!] Prerequisite: This skill should only be used AFTER the human has tested and committed the code.

Do NOT run git commit directly — the scripts below handle their own commits for .trellis/ metadata. You only need to read git history (git log, git status, git diff) and run the Python scripts.

Record Work Progress

Step 1: Get Context & Check Tasks

bash
python3 ./.trellis/scripts/get_context.py --mode record

[!] Archive tasks whose work is actually done — judge by work status, not the status field in task.json:

  • Code committed? → Archive it (don't wait for PR)
  • All acceptance criteria met? → Archive it
  • Don't skip archiving just because status still says planning or in_progress
bash
python3 ./.trellis/scripts/task.py archive <task-name>

Step 2: One-Click Add Session

bash
# Method 1: Simple parameters
python3 ./.trellis/scripts/add_session.py \
  --title "Session Title" \
  --commit "hash1,hash2" \
  --summary "Brief summary of what was done"

# Method 2: Pass detailed content via stdin
cat << 'EOF' | python3 ./.trellis/scripts/add_session.py --stdin --title "Title" --commit "hash"
| Feature | Description |
|---------|-------------|
| New API | Added user authentication endpoint |
| Frontend | Updated login form |

**Updated Files**:
- `packages/api/modules/auth/router.ts`
- `apps/web/modules/auth/components/login-form.tsx`
EOF

Auto-completes:

  • [OK] Appends session to journal-N.md
  • [OK] Auto-detects line count, creates new file if >2000 lines
  • [OK] Auto-detects Branch context (--branch override; otherwise Branch = task.json -> current git branch; missing values are omitted gracefully)
  • [OK] Updates index.md (Total Sessions +1, Last Active, line stats, history)
  • [OK] Auto-commits .trellis/workspace and .trellis/tasks changes

Script Command Reference

Command Purpose
python3 ./.trellis/scripts/get_context.py --mode record Get context for record-session
python3 ./.trellis/scripts/add_session.py --title "..." --commit "..." One-click add session (recommended)
python3 ./.trellis/scripts/task.py archive <name> Archive completed task (auto-commits)
python3 ./.trellis/scripts/task.py list List active tasks

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

mindfold-ai/Trellis

create-command

Scaffolds a new skill file with proper naming conventions and structure. Analyzes requirements to determine skill type and generates appropriate content. Use when adding a new developer workflow skill, creating a custom skill, or extending the Trellis skill set.

5,124 287
Explore
mindfold-ai/Trellis

finish-work

Pre-commit quality checklist covering lint, typecheck, tests, code-spec sync, API changes, database migrations, cross-layer verification, and manual testing. Blocks commit if infra or cross-layer specs lack executable depth. Use when code is written and tested but not yet committed, before submitting changes, or as a final review before git commit.

5,124 287
Explore
mindfold-ai/Trellis

update-spec

Captures executable contracts and coding knowledge into .trellis/spec/ documents after implementation, debugging, or design decisions. Enforces code-spec depth for infra and cross-layer changes with mandatory sections for signatures, contracts, validation matrices, and test points. Use when a feature is implemented, a bug is fixed, a design decision is made, a new pattern is discovered, or cross-layer contracts change.

5,124 287
Explore
mindfold-ai/Trellis

check

Validates recently written code against project-specific development guidelines from .trellis/spec/. Identifies changed files via git diff, discovers applicable spec modules, runs lint and typecheck, and reports guideline violations. Use when code is written and needs quality verification, to catch context drift during long sessions, or before committing changes.

5,124 287
Explore
mindfold-ai/Trellis

check-cross-layer

Post-implementation verification across multiple code dimensions: cross-layer data flow, code reuse analysis, import path validation, and same-layer consistency checks. Identifies missed update sites, type mismatches, and duplicated constants. Use when changes span 3+ architectural layers, after modifying shared constants or configs, after batch file modifications, or when creating new utility functions.

5,124 287
Explore
mindfold-ai/Trellis

start

Initializes an AI development session by reading workflow guides, developer identity, git status, active tasks, and project guidelines from .trellis/. Classifies incoming tasks and routes to brainstorm, direct edit, or task workflow. Use when beginning a new coding session, resuming work, starting a new task, or re-establishing project context.

5,124 287
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results