trellis-before-dev

Loads project-specific coding guidelines from .trellis/spec before writing code.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/dev2019zheng/codex-beacon --skill trellis-before-dev-dev2019zheng
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-before-dev
Source: https://github.com/dev2019zheng/codex-beacon/tree/main/.cursor/skills/trellis-before-dev
Command: npx skills add https://github.com/dev2019zheng/codex-beacon --skill trellis-before-dev-dev2019zheng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers often start coding without reviewing project-specific conventions, leading to inconsistent patterns and rework. This Skill ensures coding guidelines, checklists, and shared standards from the .trellis/spec directory are read before any implementation begins. ## Core Features & Use Cases - Spec Discovery: Runs get_context.py to list packages and their spec layers so you know which guidelines apply to your target package. - Pre-Development Checklists: Reads each relevant spec index and follows its Pre-Development Checklist to locate concrete guideline files like error-handling.md or 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 discover applicable backend and unit-test specs, read the checklist-referenced guideline files, and then plan your implementation against those standards. ## Quick Start Before writing any code for this task, use the trellis-before-dev skill to load the relevant project coding 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 discover spec layers, then read the relevant .trellis/spec/<package>/<layer>/index.md files and follow their Pre-Development Checklists to the actual guideline documents.

What is the .trellis/spec directory used for?▼

The .trellis/spec directory stores per-package, per-layer coding guidelines such as error-handling.md, conventions.md, and mock-strategies.md, plus shared guides under .trellis/spec/guides that apply across all packages.

When should I run the pre-development checklist?▼

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

Does this skill work without the .trellis directory?▼

No. It depends on the .trellis/scripts/get_context.py script and the .trellis/spec directory structure. Repositories without Trellis spec files have no guidelines to discover or inject.

Why is reading the spec index not enough?▼

The index only points to actual guideline files through its Pre-Development Checklist. You must open the referenced files like conventions.md or mock-strategies.md to learn the concrete coding standards and patterns.