Imported from wtthornton/agentforge-brain-plugin (
.tapps-mcp/backups/2026-08-04-165150/.claude/skills/tapps-finish-task/SKILL.md). Install upstream withnpx skills add wtthornton/agentforge-brain-plugin --skill tapps-finish-task. Copyright stays with the author.
Close out the current task end-to-end. Run each step; do NOT skip one that failed — surface the failure and stop.
-
Validate changed files. Identify the files you edited this session (git status, your edit history). Call
mcp__nlt-build__tapps_validate_changedwith explicitfile_paths(comma-separated) scoped to those files. Never call withoutfile_paths. Default is quick mode. If any file fails, list it with the top blocking issue and stop — the task is not complete. Do not proceed to step 2 until all changed files pass.Call graph:
include_impactdefaults to true —tapps_validate_changedrefreshes the cache viatapps_diff_impact. Before function-level refactors, calltapps_call_graph(symbol='...', query='callers'). -
Verify the checklist. Call
mcp__nlt-build__tapps_checklist(task_type=<feature|bugfix|refactor|security|review>). Read the inlineusage_gapsblock — not onlycomplete/missing_steps. Ifcomplete: false, address each entry inmissing_stepsand re-run. -
Clear doc-lookup gaps. When
usage_gaps.gapsincludeslookup_docs_underused,library_uses_without_lookup_docs, orlibraries_without_lookupis non-empty:- Call
mcp__nlt-build__tapps_lookup_docs(library=<name>, topic=<relevant-api>)for each listed library (retrospective MCP lookups clear telemetry gaps; cache hits are fine — ADR-0021). - CLI
tapps-mcp lookup-docsalso records.lookup-docs-events.jsonlfor the next session. - Re-run
mcp__nlt-build__tapps_checklistuntilusage_gaps.gapsis empty andcomplete: true. Prefer lookup before the first edit that uses each external library in future sessions.
- Call
3b. Creator-verifier (feature/review). Before declaring done on feature or review work,
spawn a fresh verifier context (separate review agent / Bugbot / tapps-reviewer)
that did not implement the change. Deterministic tapps_validate_changed alone is
scrutiny — not creator-verifier. After the verifier passes:
uv run tapps-mcp pipeline-mark creator-verifier.
If the work changed observable behavior, also ensure a validation contract was verified:
uv run tapps-mcp pipeline-mark contract-verified (draft via /tapps-validation-contract if missing).
Re-run mcp__nlt-build__tapps_checklist until contract_assertions_unverified and creator_verifier_skipped
are absent from usage_gaps.gaps and complete: true.
-
Save learnings (conditional). If this session produced a non-obvious architectural or pattern-level decision — a new convention, a subtle trade-off, a gotcha someone else would re-discover — run
uv run tapps-mcp memory save --key <slug> --tier <architectural|pattern> --value "<concise decision>"(CLI via BrainBridge). Skip for routine fixes, refactors where the code documents the decision, or trivial bugfixes. Brain offline → skip silently. -
Report. Emit a one-line summary:
Files validated: N pass. Checklist: <task_type> complete. Doc gaps: cleared|none. Memory saved: yes|no.If any step failed or was skipped, say so explicitly. -
Transfer (optional). If the user is ending the chat and wants the next session to pick up cleanly, invoke
/tapps-handoff-sessioninstead of pasting a long prompt.
