Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Get Started Free →

Project Architecture Guardrails · aiskillstore | DecimalAI

documentationby aiskillstore

Project Architecture Guardrails

aiskillstore/project-architecture

Source aiskillstore/marketplace ↗License Apache-2.0

Overview of the project's tech stack, directory structure, and architectural patterns.

SkillScore100Maintained

Automatic

Coding pack

Last verified 8/22/2026

What it changes

Passed 22 of 22 test cases with the skill, and 8 of 22 without it.

Without skill36%

With skill100%

Checks it passed that the model alone missed

Specifies Next.js 15
Specifies npm run dev:root
Specifies npm run dev:docs

and 20 more in the full report

14 fixed8 passed either way0 still failing0 broke

Pass-rate lift: +64 pp
Tokens: -32%
Agent turns: 0%
Response time: -57%

Model gemini-3.6-flashMeasured 8/22/2026v1 · latest is v222 of 22 cases passed with skill

Tokens, turns and time describe resource use, not a dollar price.

This benchmark measured an earlier version of the skill.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/aiskillstore-project-architecture/SKILL.md https://app.decimal.ai/s/aiskillstore-project-architecture/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add aiskillstore-project-architecture, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/aiskillstore-project-architecture/ and pins it in .decimal/skills.lock

decimalai skills add aiskillstore-project-architecture

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/aiskillstore-project-architecture/SKILL.md https://app.decimal.ai/s/aiskillstore-project-architecture/SKILL.md

Raw file: /s/aiskillstore-project-architecture/SKILL.md ↗ · machine-readable summary at /s/aiskillstore-project-architecture.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 14 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 14

Prompt

We are creating new routes for our application and considering whether to use Pages Router or another setup. What specific web framework, framework version, and router model does our codebase mandate?

What was checked, without and with the skill
Checked	Without skill	With skill
Specifies Next.js 15	Missed	Passed
Specifies Next.js App Router	Missed	Passed

case-07 · gemini-3.6-flash · 8/22/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md46 lines3 files

Project Architecture Guardrails

Activation Contract

Load this skill before changing UI, layout, component structure, state flow, theming, data display, or the server/client boundary of a Next.js or Astro app.

Hard Rules

Detect the framework from the project before acting; never assume it.
Keep rendering server-first. Add client-side code only when the interaction cannot work without it, and keep that surface as small as possible.
Read the installed framework's own docs before changing framework APIs or project structure.
Follow DESIGN.md for visual and UX decisions when it exists.
Build from existing shadcn primitives and semantic tokens before writing custom markup or styles; load shadcn-component-boundaries when it is installed.
Make loading, empty, and error states explicit for every data display.
Add tests proportional to risk, using the test tooling the project already has.

Decision Gates

Project signal	Framework	Guidance
`next` in `package.json` dependencies, or a `next.config.*` file	Next.js	references/next.md
`astro` in `package.json` dependencies, or an `astro.config.*` file	Astro	references/astro.md
Both or neither	Unknown	Stop and ask which app the change targets

Execution Steps

Read package.json and list the root config files to detect the framework.
Load the matching reference and apply its boundary rules.
Search existing components, routes, and styles before creating new ones.
Implement the change with the smallest client-side surface that works.
Answer the pre-close checklist, then load project-min-evaluation when it is installed, or run the project's quality scripts.

Pre-close checklist:

Did the change add unnecessary client-side surface?
Does it follow DESIGN.md?
Are loading, empty, and error states explicit?

Output Contract

Track record

Benchmark

22 / 22

test cases passed, vs 8 / 22 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v5 — 10/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

aiskillstore / marketplace

skills/abdulsamad94/project-architecture/SKILL.md

View on GitHub ↗

License Apache-2.0Imported 10/3/2026Version v2Bundled 2 files

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

Project Architecture Guardrails

Activation Contract

Hard Rules

Decision Gates

Execution Steps

Output Contract

Track record

Benchmark

Adoption

SkillSafety

Source

Related skills