Verified:GitHub

trellis-before-dev

Loads project-specific coding guidelines from .trellis/spec/ before implementation begins.

4|1|Updated Apr 29, 2026

Search Tags:#checklist #conventions #code standards #pre-development #coding guidelines #trellis #spec discovery

One-click install

npx skills add https://github.com/ZipperCode/lingma2api --skill trellis-before-dev-zippercode

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: trellis-before-dev
Source: https://github.com/ZipperCode/lingma2api/tree/main/.opencode/skills/trellis-before-dev
Command: npx skills add https://github.com/ZipperCode/lingma2api --skill trellis-before-dev-zippercode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers often start writing code without reviewing project-specific conventions, leading to inconsistent patterns, rework, and style violations. This Skill ensures the relevant coding standards and pre-development checklists are read before any code is written. ## Core Features & Use Cases - Spec Discovery: Runs a Python script to enumerate packages and their spec layers under .trellis/spec/. - Checklist-Driven Reading: Follows the Pre-Development Checklist in each package's index.md to locate the actual guideline files such as error-handling.md and conventions.md. - Shared Guides: Always loads the shared thinking guides in .trellis/spec/guides/ alongside package-specific specs. - Use Case: Before modifying the cli/ package, run this Skill to discover which backend and unit-test guidelines apply, read them, and then plan the implementation accordingly. ## Quick Start Before writing any code for this task, use the trellis-before-dev skill to load the relevant project guidelines from .trellis/spec/.

Frequently Asked Questions about trellis-before-dev

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

FAQPage Schema

How do I load project coding guidelines before writing code?▼

Run python3 ./.trellis/scripts/get_context.py --mode packages to list packages and spec layers, then read the index.md for each relevant package and follow its Pre-Development Checklist to the actual guideline files.

What is the .trellis/spec directory structure?▼

The .trellis/spec directory organizes guidelines by package and layer, with each package containing an index.md that points to specific guideline files like error-handling.md, conventions.md, and mock-strategies.md, plus a shared guides directory.

When should I run the pre-development checklist?▼

Run it before writing any code, when switching to a different package, or when you need to refresh project conventions. The Skill treats this step as mandatory before implementation begins.

Does this skill work without the .trellis directory?▼

No. The Skill depends on the .trellis/scripts/get_context.py script and the .trellis/spec/ directory tree. Without them, the discovery commands will fail and no guidelines can be loaded.