trellis-update-spec

Capture executable code-specs from debugging sessions and design notes.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/imbingox/acex --skill trellis-update-spec-imbingox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trellis-update-spec
Source: https://github.com/imbingox/acex/tree/main/.agents/skills/trellis-update-spec
Command: npx skills add https://github.com/imbingox/acex --skill trellis-update-spec-imbingox

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture executable code-specs from debugging sessions and design discussions to preserve concrete contracts and decisions for future work.

Core Features & Use Cases

  • Create concrete code-signatures, payload structures, and environment requirements that can be tested and validated.
  • Document design decisions and cross-layer contracts to guide future implementation.
  • Record change history, tests, and validation steps to prevent regressions.

Quick Start

Run the Trellis update-spec workflow after completing a debugging or design session to generate and store the updated code-spec.

Frequently Asked Questions about trellis-update-spec

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

FAQPage Schema
How do I document code-specs and design decisions after a debugging session?

To document code-specs after a debugging session, you can automate capturing executable code-specs using a structured 7-section template. This preserves concrete signatures, payload structures, and cross-layer contracts for future implementation.

What is the best way to record cross-layer contracts and payload structures for future implementation?

Recording cross-layer contracts is best handled by enforcing a standardized code-spec template with required frontmatter. This captures precise signatures and environment requirements to guide future development and prevent regressions.

Can I use this workflow to document bug fixes and feature implementations together?

Yes, you can use this workflow to document both bug fixes and feature implementations. It applies to any scenario where precise signatures, change history, and validation steps must be recorded to maintain code-spec accuracy.

How do I prevent regressions when capturing executable code-specs from design notes?

You prevent regressions by recording change history, tests, and validation steps within the code-spec. This ensures that every documented design decision and payload structure can be tested and validated against future updates.

Do I need specific frontmatter to store updated code-specs?

Yes, you need frontmatter containing a name and description to store updated code-specs. This requirement enforces consistent metadata tagging across all documented design decisions and debugging sessions.

Does the code-spec template support extended context for complex environment requirements?

Yes, the code-spec template supports optional resources folders for extended context. This allows you to store additional environment details and supporting files alongside the core 7-section code-spec documentation.