update-spec

Classify learned insights into design decisions, conventions, patterns, or gotchas and update spec files.

Updated Feb 23, 2026
One-click install
npx skills add https://github.com/TbK0ng/mytrellis --skill update-spec-tbk0ng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-spec
Source: https://github.com/TbK0ng/mytrellis/tree/main/.agents/skills/update-spec
Command: npx skills add https://github.com/TbK0ng/mytrellis --skill update-spec-tbk0ng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Knowledge gained during debugging, design decisions, and implementation often gets scattered across conversations, documents, and code. This Skill provides a structured workflow to capture those learnings and translate them into up-to-date specifications, preventing knowledge loss and guiding future work.

Core Features & Use Cases

  • Structured updates: Classifies insights into design decisions, project conventions, new patterns, and common mistakes, storing them in the appropriate spec files.
  • Template-driven documentation: Encourages consistent documentation with guided templates to keep specs current.
  • Institutional memory: Creates a reliable record of decisions and rationale to onboard new team members and maintain context across tasks.

Quick Start

Run the update-spec flow after completing a task to capture knowledge into the relevant spec.

Frequently Asked Questions about update-spec

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

FAQPage Schema
How do I document design decisions and coding guidelines after a debugging session?

Capture design decisions and coding guidelines by classifying insights from debugging sessions into patterns, conventions, or gotchas, and update relevant spec files using provided templates to maintain institutional memory.

What is the best way to capture project conventions and prevent knowledge loss?

Capture project conventions by translating newly learned insights into up-to-date specifications using template-driven documentation, creating a reliable record of decisions and rationale to prevent knowledge loss across tasks.

How do I update spec files to keep project documentation current?

Update spec files by running a structured flow after completing tasks to identify what was learned, classifying it into design decisions or common mistakes, and storing it in appropriate spec files with guided templates to keep documentation current.

Can I classify new patterns and common mistakes into existing project specifications?

Yes, you can classify new patterns and common mistakes into existing project specifications by identifying what was learned during feature work and applying template-driven updates to relevant spec files to guide future work.

Does template-driven documentation work for onboarding new team members with design decisions?

Template-driven documentation works for onboarding new team members by creating a reliable record of design decisions and rationale, ensuring consistent documentation and maintaining context across tasks to guide future work.