trellis-before-dev

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

1|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/MaplumeX/Milesto --skill trellis-before-dev-maplumex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-before-dev
Source: https://github.com/MaplumeX/Milesto/tree/main/.agents/skills/trellis-before-dev
Command: npx skills add https://github.com/MaplumeX/Milesto --skill trellis-before-dev-maplumex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers often start coding without reviewing project conventions, leading to inconsistent patterns, rejected reviews, and rework. This Skill ensures coding standards, error-handling rules, and testing strategies are loaded into context before any code is written. ## Core Features & Use Cases - Spec Discovery: Runs get_context.py to enumerate packages and their spec layers so you know which guidelines apply to your target package. - Checklist-Driven Reading: Follows the Pre-Development Checklist in each spec index to locate concrete guideline files like error-handling.md and conventions.md. - Shared Guides: Always loads the shared thinking guides under .trellis/spec/guides/ for cross-package standards. - Use Case: Before modifying the cli/ package, run this Skill to read the backend and unit-test spec indexes, then follow the listed guideline files so your implementation matches project conventions from the start. ## Quick Start Before writing any code, load the Trellis development guidelines for the package I am about to modify.

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 discover spec layers, then read the relevant index.md files under .trellis/spec/<package>/<layer>/ and follow their Pre-Development Checklist to the actual guideline files.

What is the Trellis pre-development checklist?▼

It is a section inside each spec layer's index.md that lists the specific guideline files to read before coding, such as error-handling.md, conventions.md, and mock-strategies.md. The index points you to the real standards documents.

When should I run the before-dev guideline discovery step?▼

Run it when starting a new coding task, before writing any code, when switching to a different package, or when you need to refresh project conventions. The step is mandatory before implementation begins.

Does this work for both backend and frontend packages?▼

Yes. The spec layers are organized per package and per work type, covering backend, frontend, unit-test, and docs. You identify which specs apply based on the package you modify and the type of work.

What happens if I skip reading the shared guides?▼

Skipping .trellis/spec/guides/index.md means missing cross-package standards that apply to all work. The Skill marks reading shared guides as an always-required step alongside package-specific specs.