Agent Architecture Analysis

If you're building LLM agents and want to know whether your architecture is actually production ready, this performs a deep 12 Factor Agents audit against your codebase. It searches for specific patterns across 13 factors like structured outputs, prompt ownership, state management, and human in the loop tooling, then scores each as Strong, Partial, or Weak with file level evidence and code citations. The workflow enforces hard gates so you get real findings, not vibes. Use it when evaluating a new agent system, auditing something before production, or planning architectural improvements. Think of it as a systematic code review specifically for agentic patterns, not a quick checklist.

skills.sh installs: 217
GitHub stars: 87
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add existential-birds/beagle --skill agent-architecture-analysis --agent claude-code

Installs into .claude/skills of the current project.

Files

12-Factor Agents Compliance Analysis

Reference: 12-Factor Agents

Input Parameters

Parameter	Description	Required
`docs_path`	Path to documentation directory (for existing analyses)	Optional
`codebase_path`	Root path of the codebase to analyze	Required

Analysis Framework

The full per-factor rubric — principle, search patterns, file patterns, compliance criteria (Strong/Partial/Weak), and anti-patterns for each of the 13 factors — lives in references/factors.md. During the Analysis Workflow, read the relevant factor sections there for the search patterns to run and the criteria to score against.

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly