AI Governance for Developers

Your AI agent has amnesia every session.

Every time you start a new chat with Copilot, Cursor, or Claude — it starts from zero. No memory of your architecture decisions. No idea what patterns are locked. No clue where you left off.

AppShield gives your repo the 7 governance files your AI agent reads before touching a single line of code. We score how healthy those files are — and tell you exactly what to fix.

Download Template

Free scan · No credit card · You own every file you commit.

The 7 files that orient your AI agent

The AppShield governance template creates these files in your docs/ folder. Your AI agent reads them before every session. AppShield scores each one for presence, completeness, and freshness.

docs/session-handoff.md7-day freshness
Session Handoff

Where the project stands right now. Updated every session. Goes stale after 7 days — the heartbeat of your governance score.

docs/agent-workflow.md
Agent Workflow

How AI agents should operate in this codebase — what to read first, what to never touch, when to ask for human approval.

docs/locked-patterns.md
Locked Patterns

Patterns that must never be changed without explicit human sign-off. Auth, schema, API contracts.

docs/decision-log.md
Decision Log

A running log of every major architectural decision and its rationale. AI references this before proposing changes.

docs/conventions.md
Conventions

Naming standards, code style, folder structure. One source of truth for how this codebase is organized.

docs/knowledge-base.md
Knowledge Base

Project overview, architecture decisions, known issues, and key dependencies — the context an AI needs to not hallucinate.

docs/update-process.md
Update Process

When and how documentation is updated, by whom, and how updates are reviewed before committing.

From zero to a scored repo in one session

The template does the heavy lifting. You fill in the details. Your AI agent does the rest.

Step 01

Download the template

Get the 7 governance files pre-structured with placeholder sections. Commit them to your repo's docs/ folder. You own every file — AppShield never installs anything.

Step 02

Ask your AI agent to fill it in

Open a session and tell your agent: "Read SETUP_GUIDE.md and interview me to fill in all 7 docs/ files." It asks the right questions. You answer. Done in minutes.

Step 03

Scan, score, repeat

Paste your repo into AppShield. See your score. Quick Wins tell you exactly which placeholders remain or which files are going stale. Update session-handoff.md every session to keep the heartbeat alive.

How the score is calculated

Each of the 7 docs is scored 0–100 on three factors. Your overall AppShield score is the average across all 7.

+40 pts
Presence
Does the file exist at all?
+30 pts
Completeness
Are placeholders filled in? Does it have enough content (100+ words)?
+30 pts
Freshness
Has it been updated recently? session-handoff.md stales in 7 days. All others stale in 30.
yourname/your-repo74
docs/session-handoff.md
fresh95
docs/agent-workflow.md
fresh85
docs/locked-patterns.md
active80
docs/decision-log.md
active75
docs/conventions.md
stale60
docs/knowledge-base.md
placeholder40
docs/update-process.md
missing0
Quick Win
Add docs/update-process.md to unlock +40 pts instantly

“We took a real repo from a score of 11 to 85 in one session. The AI in the next session needed half as many clarifications.”

— TraghmTech, building with AI daily

Simple pricing

Start free. Upgrade when your repos do.

Free
$0forever
  • 1 repo
  • 1 scan / day
  • Full AppShield Score
  • Top 6 quick wins
MOST POPULAR
Builder
$8.99/month
  • Up to 10 repos
  • Unlimited scans
  • Scan history
  • Score trend over time
Team
$29/month
  • Unlimited repos
  • Unlimited scans
  • Team members
  • Shareable score badges