trellis-update-spec

Document executable contracts and coding conventions into .trellis/spec/ files.

2|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/TECNB/MediaNexus --skill trellis-update-spec-tecnb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trellis-update-spec
Source: https://github.com/TECNB/MediaNexus/tree/main/.agents/skills/trellis-update-spec
Command: npx skills add https://github.com/TECNB/MediaNexus --skill trellis-update-spec-tecnb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This frontmatter-driven skill helps teams prevent knowledge decay by turning learning moments into executable code-spec updates that define signatures, contracts, and test expectations.

Core Features & Use Cases

  • Captures concrete code contracts (signatures, payload fields, env keys) and coding conventions into .trellis/spec/ for future reference.
  • Documents decisions from debugging, implementation, or design discussions to guide future work and prevent regressions.
  • Use Case: after implementing a feature or fixing a bug, generate a structured spec to ensure consistency across teams and environments.

Quick Start

Use this after completing a debugging or design task to create a new code-spec entry that documents the outcome.

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 coding conventions and executable contracts after a debugging session?

To document coding conventions and executable contracts after a debugging session, you capture decisions, signatures, and boundary behavior into structured .trellis/spec/ files. This organizes scope, validation, and test expectations to guide future development and prevent regressions.

What is the best way to prevent knowledge decay from feature implementation and design discussions?

Preventing knowledge decay from feature implementation involves turning learning moments into structured code-spec updates. You record payload fields, environment keys, and contracts from design discussions into .trellis/spec/ files, ensuring consistency across teams and environments.

How do I generate code-spec files that capture signatures and test expectations?

You generate code-spec files by applying a spec-management process that enforces mandatory Code-Spec depth. This structures scope, signatures, contracts, validation, and tests into a target spec file, directly capturing executable contracts from your recent learning sessions.

When do I need to create a spec file for code contracts and boundary behavior?

You need to create a spec file for code contracts and boundary behavior immediately after completing a debugging, implementation, or design task. This captures the outcome and defines specific payload fields and environment keys for future reference.

Can I use this spec-management approach to document environment keys and payload fields for future work?

Yes, you can use this spec-management approach to document environment keys and payload fields for future work. It captures concrete code contracts and coding conventions from implementation sessions into .trellis/spec/ files, preventing regressions and guiding future work.

Does trellis-update-spec work without external dependencies for capturing design decisions?

Yes, trellis-update-spec works without external dependencies for capturing design decisions. It operates as a frontmatter-driven skill to independently organize decisions, signatures, and validation rules into target spec files during your workflow.