CtrlK
BlogDocsLog inGet started
Tessl Logo

engram-project-structure

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

80

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

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.
Repository
Gentleman-Programming/engram
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.