skills.rest
MaplumeX
MaplumeXCOMMUNITY
Explore all skills by this author →
GitHub

trellis-finish-work

Archives completed tasks and records session journal entries after verifying the working tree state.

1|Updated Jan 22, 2026
Search Tags:#git#workflow automation#trellis#session wrap-up#task archiving#developer journal
One-click install
npx skills add https://github.com/MaplumeX/Milesto --skill trellis-finish-work-maplumex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-finish-work
Source: https://github.com/MaplumeX/Milesto/tree/main/.agents/skills/trellis-finish-work
Command: npx skills add https://github.com/MaplumeX/Milesto --skill trellis-finish-work-maplumex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Ending a coding session cleanly requires several bookkeeping steps: confirming the quality gate passed, ensuring work is committed, archiving finished tasks, and logging session progress. This Skill automates that wrap-up sequence so nothing is forgotten. ## Core Features & Use Cases - State Survey: Runs get_context.py in record mode to list active tasks, git status, and recent commits before wrapping up. - Dirty Path Classification: Inspects git status, filters Trellis-managed paths, and routes uncommitted changes back to the commit phase or flags parallel-window work. - Task Archival & Journaling: Archives completed tasks via task.py and records a session journal with commit hashes and a summary via add_session.py. - Use Case: After finishing a feature and committing code in workflow Phase 3.4, invoke this Skill to archive the task and append a journal entry, producing a clean chore-commit history. ## Quick Start Ask the AI to finish the current Trellis work session by archiving the active task and recording the session journal.

Frequently Asked Questions about trellis-finish-work

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I archive a completed task in a Trellis workflow?▼

Run task.py archive with the task name, which the finish-work Skill does automatically for the active task. Each archive produces a chore(task): archive commit via the script's auto-commit behavior.

How to record a development session journal with git commits?▼

Use add_session.py with --title, --commit, and --summary arguments, passing the work-commit hashes from the commit phase. This creates a chore: record journal commit after the archive commits.

Does finish-work commit my code changes automatically?▼

No, code commits are explicitly not done by this Skill. If uncommitted task-related changes are detected in git status, the Skill bails out and directs you back to workflow Phase 3.4 to commit them first.

What happens when dirty files belong to another terminal window?▼

The Skill classifies each dirty path by checking task files and session memory. Paths judged as unrelated parallel work are reported once and left untouched, while genuinely ambiguous paths trigger a single user confirmation.

Why does finish-work skip the archive step sometimes?▼

Archiving is skipped when there is no active task and the user declined cleanup of other completed tasks. The Skill then proceeds directly to recording the session journal.

Related Skills

Explore More Software Engineering Skills→
LonelyHerbivoreLonelyHerbivore
92

trellis-finish-work

Archive completed Trellis tasks and record a session journal after verifying quality gates.

Community
Intermediate
Tendo33Tendo33
45

trellis-finish-work

Archive completed tasks and record session progress to the developer journal.

Community
Advanced
winetree94winetree94

verification-before-completion

Execute deterministic validation checks and report completion with evidence.

Community
Intermediate
EcoPasteHubEcoPasteHub
7.3k

trellis-finish-work

Archives completed tasks and records session journals after verifying git working tree state.

Official
Intermediate