Home / tartinerlabs / skills · skills/project-structure/SKILL.md · GitHub

project-structure skillA

project-structure is agent-read markdown (skill) from tartinerlabs/skills: Use when deciding where code should live, organising files, or auditing project structure. Checks colocation, grouping, and directory anti-patterns..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

You are a project structure expert.

Audit and report by default; move files only when the user asks you to fix, reorganise, or apply something. When the ask is unclear, report first and offer to apply the fixes.

## Rules Overview

| Rule | Impact | File |
|------|--------|------|
| Colocation | HIGH | `rules/colocation.md` |
| Anti-patterns | HIGH | `rules/anti-patterns.md` |
| Feature-based grouping | MEDIUM | `rules/feature-based.md` |
| Layer-based grouping | MEDIUM | `rules/layer-based.md` |
| Framework structure | MEDIUM | `rules/framework-structure.md` (only when a supported framework is detected) |

## Workflow

### Step 1: Detect Project Type

Scan for project indicators to determine the appropriate organisation approach:

- Feature-heavy app (SPA, Next.js/React, or any UI-driven codebase) → feature-based
- Service / API (Express, Fastify, Hono, Django, FastAPI, Go, Rails, …) → layer-based
- Monorepo (`apps/` + `packages/`, or workspace manifests) → hybrid
- Existing structure → respect and extend current patterns
…

Read the whole file at its exact version.

How to install

Latest version
mdr add tartinerlabs/skills/project-structure@git:20260726.9b1c2f9
Exact content
mdr add tartinerlabs/skills/project-structure@sha256:0d372acedd435ea1

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_qyxbxstkztvlabrb.svg)](https://markdownregistry.com/a/art_qyxbxstkztvlabrb)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260726.9b1c2f9 latest2026-07-26 9b1c2f9 2,612 BA view · diff
git:20260726.40e457e2026-07-26 40e457e 2,769 BA view · diff
git:20260718.45adc4f2026-07-18 45adc4f 2,684 BA view · diff
git:20260715.6db00512026-07-15 6db0051 2,233 BA view · diff
git:20260715.4d8d45a2026-07-15 4d8d45a 2,080 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2612 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

tartinerlabs/skills · 8 stars · license MIT · pushed 2026-09-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_qyxbxstkztvlabrb
GET https://markdownregistry.com/api/v1/resolve?ref=tartinerlabs/skills/project-structure
GET https://markdownregistry.com/api/v1/blob/0d372acedd435ea164457f509264908b14a7d55dc3bb83367cd0e94a5cd6a3f6

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from tartinerlabs/skills

AGENTS.md agents
tartinerlabs/skills · AGENTS.md
git:20260726.0241bb2 · audit A · 8 stars
CLAUDE.md claude
tartinerlabs/skills · CLAUDE.md
git:20260726.3dddebc · audit A · 8 stars
commit skill
tartinerlabs/skills · skills/commit/SKILL.md · Use when committing changes, staging files, saving work, or making a git commit. Creates clean commits in the…
git:20260726.9b1c2f9 · audit A · 8 stars
create-branch skill
tartinerlabs/skills · skills/create-branch/SKILL.md · Use when creating a branch, starting work on an issue, or checking out a new feature branch. Validates branch naming…
git:20260807.4d3d994 · audit A · 8 stars
create-pr skill
tartinerlabs/skills · skills/create-pr/SKILL.md · Use when opening a PR, submitting for review, pushing a branch, or creating a pull request. Pushes and creates GitHub…
git:20260820.7bc4969 · audit A · 8 stars
deps skill
tartinerlabs/skills · skills/deps/SKILL.md · Use when hardening a dependency supply chain, pinning versions, adding registry/security flags, or setting up Renovate…
git:20260823.7490cdf · audit A · 8 stars
github-actions skill
tartinerlabs/skills · skills/github-actions/SKILL.md · Use when adding CI/CD, creating workflows, auditing GitHub Actions, or fixing action pinning. Creates and audits…
git:20260823.ba8e2e6 · audit A · 8 stars
github-issues skill
tartinerlabs/skills · skills/github-issues/SKILL.md · Use when filing a bug, requesting a feature, creating an issue, or updating issue details. Manages issues on GitHub…
git:20260817.a873993 · audit A · 8 stars
naming-format skill
tartinerlabs/skills · skills/naming-format/SKILL.md · Use when reviewing file names, renaming files, fixing naming conventions, or auditing exports. Enforces consistent…
git:20260726.9b1c2f9 · audit A · 8 stars
refactor skill
tartinerlabs/skills · skills/refactor/SKILL.md · Use when refactoring, cleaning up code, reducing complexity, fixing code smells, or improving code quality. Audits code…
git:20260726.9b1c2f9 · audit A · 8 stars
security skill
tartinerlabs/skills · skills/security/SKILL.md · Use when auditing security, checking for vulnerabilities, scanning for secrets, or reviewing dependencies. Dependency…
git:20260823.ba8e2e6 · audit A · 8 stars
setup skill
tartinerlabs/skills · skills/setup/SKILL.md · Use when setting up a project, adding linting, formatting, git hooks, or type checking. Detects the language and…
git:20260823.ba8e2e6 · audit A · 8 stars

Every file in tartinerlabs/skills

Other files named project-structure

project-structure skill
steipete/agent-scripts · skills/project-structure/SKILL.md · Generate a single-file compressed symbol map of a TypeScript or Swift repository — files, exported symbols, typed…
git:20260810.d382dba · audit A · 6,649 stars
project-structure skill
ex3del/mast · plugins/en/skills/project-structure/SKILL.md · English-language body. Use when deciding where a document, note, or decision belongs in the project — ROADMAP.md, a…
git:20260922.6dd74b2 · audit A · 5 stars
project-structure skill
ex3del/mast · plugins/ru/skills/project-structure/SKILL.md · Инструкции на русском. Используй, когда решаешь, куда записать документ, заметку или решение в проекте — ROADMAP.md…
git:20260922.6dd74b2 · audit A · 5 stars

Browse by kind, by grade A, or by owner.