MCPInstall

engram-project-structure

by gentleman-programmingTesting & QA

Repository structure and placement rules for Engram. Trigger: Creating files, packages, handlers, templates, styles, or tests in this repo.

Installs
71
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/gentleman-programming/engram --skill engram-project-structure
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads engram-project-structure automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

When to Use

Use this skill when:

  • Creating a new package, file, or directory
  • Deciding where code belongs
  • Adding tests, templates, assets, or docs

Placement Rules

  1. Put behavior near its domain, not near the caller that happens to use it.
  2. Keep templates in internal/cloud/dashboard/*.templ and generated files checked in.
  3. Keep dashboard styling in internal/cloud/dashboard/static/styles.css unless a new static asset is clearly needed.
  4. Put HTTP handlers in server packages, not in store packages.
  5. Put persistence queries in store/cloudstore, not in handlers.

File Creation Rules

  • New route -> handler + tests in dashboard/server package
  • New DB behavior -> store/cloudstore code + focused tests
  • New UI partial/page -> templ component + generated _templ.go
  • New contributor guidance -> update docs/catalog in same change

Anti-Patterns

  • Do not mix SQL, HTML, and transport logic in one file.
  • Do not create utility packages for one-off helpers.
  • Do not add package layers unless they remove real coupling.

FAQ

What does the engram-project-structure skill do?

Repository structure and placement rules for Engram. Trigger: Creating files, packages, handlers, templates, styles, or tests in this repo.

How do I install engram-project-structure?

Run npx skills add https://github.com/gentleman-programming/engram --skill engram-project-structure in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/engram-project-structure/ (personal) or .claude/skills/engram-project-structure/ (project).

Which AI agents can use engram-project-structure?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is engram-project-structure safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains engram-project-structure?

It is published by gentleman-programming in gentleman-programming/engram. It has 71 recorded installs.

More from gentleman-programming/engram

View all →

engram-memory-protocol

gentleman-programming/engram

Persistent memory discipline for Engram contributors. Trigger: Decisions, bugfixes, discoveries, preferences, or session closure.

225 installs

engram-memory

gentleman-programming/engram

ALWAYS ACTIVE — Persistent memory protocol. You MUST save decisions, conventions, bugs, and discoveries to engram proactively. Do NOT wait for the user to ask.

147 installs

engram-testing-coverage

gentleman-programming/engram

TDD and coverage standards for Engram. Trigger: When implementing behavior changes in any package.

Testing & QA98 installs

engram-branch-pr

gentleman-programming/engram

PR creation workflow for Engram following the issue-first enforcement system. Trigger: When creating a pull request, opening a PR, or preparing changes for review.

Code Quality & Workflow92 installs

engram-sdd-flow

gentleman-programming/engram

Open the skill to read its SKILL.md instructions.

89 installs

engram-docs-alignment

gentleman-programming/engram

Documentation alignment rules for Engram. Trigger: Any code or workflow change that affects user or contributor behavior.

Docs & Writing89 installs

Popular testing & qa skills

View category →

tdd

mattpocock/skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Testing & QA1.2M installs

grilling

mattpocock/skills

Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.

Testing & QA996.2K installs

migrate-to-shoehorn

mattpocock/skills

Migrate test files from as type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace as in tests, or needs partial test data.

Testing & QA484.1K installs

run-train

lllllllama/rigorpilot-skills

Rigor Train skill for deep learning research repositories. Use when a documented or selected training command should be run conservatively for startup verification, short-run verification, full kickoff, or resume, with command, config, seed, log, checkpoint, status, and metric evidence written to standardized trainoutputs/. Do not use for environment setup, exploratory sweeps, speculative idea implementation, or end-to-end orchestration.

Testing & QA337.8K installs

test-driven-development

obra/superpowers

Use when implementing any feature or bugfix, before writing implementation code

Testing & QA261.8K installs

finishing-a-development-branch

obra/superpowers

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work

Testing & QA216.8K installs