security-architecture-review
Skill17 starsChanged 47 days agoMITView on GitHub
Review security architecture and trust boundaries — use for design-level control gaps across authZ, secrets, egress, multi-tenant isolation, and insecure-by-design features (A04:2021) before or with /axguard-audit.
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 62
Do agents/tools inherit over-broad credentials?
- Distinctive: line 68
Check tenant isolation model (row-level, schema, DB-per-tenant) and failure modes.
- Distinctive: line 84
Do not claim RCE from architecture alone.
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Security Architecture Review
Purpose
Perform a design-level security architecture review: whether trust boundaries, control placement, and isolation strategies are fit for the app’s risk — catching insecure design before (or while) hunting implementation bugs.
When to Use / When Not to Use
Use when:
- New product, major rewrite, multi-tenant SaaS, payments, agents with tools, or significant cloud redesign.
- CSO/
/axguard-csolead pass needs architecture context. - Threat model shows systemic issues (no authZ layer, shared DB without tenants, secrets in clients).
Do not use when:
- Single-line sink fix with clear local remediation.
- Pure secret scanning without design questions (
secrets-detection).
Security Concepts
Insecure design (A04) is missing or misplaced controls, not just missing patches. Good architecture places authN/authZ, validation, secrets, and egress policy at boundaries — with defense in depth, not a single UI check.
Threat Model
Architecture review asks:
- What happens if one component is compromised?
- Can tenants/users cross isolation barriers by design?
- Are privileged operations reachable with weak step-up?
- Do agents/tools inherit over-broad credentials?
Analysis Workflow
- Draw trust boundaries: client, edge, app, data, jobs, IdP, cloud APIs, agent tools.
- For each boundary: authN method, authZ enforcement point, encryption in transit/at rest expectations.
- Check tenant isolation model (row-level, schema, DB-per-tenant) and failure modes.
- Review secrets: where created, stored, injected; client exposure; rotation.
- Review egress: SSRF-prone features, metadata exposure, third-party token relay.
- Review admin/break-glass paths and debug surfaces in production designs.
- For AI agents: tool allowlists, human approval, credential scoping.
- Output architecture risks as design findings + which implementation skills to run next.
Evidence Requirements
Architecture findings need:
- Diagram or clear boundary description
- Missing/misplaced control (not just “could be better”)
- Realistic abuse case
- Recommended control — confidence usually MEDIUM until implementation proof
Do not claim RCE from architecture alone.
False Positive Controls
- Compensating controls proven in code/deploy (WAF alone is not sufficient authZ)
- Risks accepted explicitly with documented owners/expiry
- Aspirational hardening outside current scope — track as backlog, not critical vuln
Remediation
- Move authZ to a consistent server-side policy layer.
- Enforce tenant isolation in data access APIs.
- Introduce secret management, short-lived creds, least privilege IAM.
- Constrain egress and metadata hops; segment admin planes.
- Reduce agent/tool blast radius; separate duties.
Verification
Architecture notes → Control backlog → Implementation skills + axguard audit → Re-review boundaries after major changesRelated Skills
threat-modeling,attack-surface-mappingapi-security,authentication-analysis,authorization-analysisssrf-analysis, cloud/secrets skills as applicable
Framework Mapping
- OWASP A04:2021 Insecure Design; A01:2021 Broken Access Control
- OWASP API8:2023 Security Misconfiguration; API9:2023 Improper Inventory Management
References
- https://owasp.org/Top10/A04_2021-Insecure_Design/
- https://owasp.org/Top10/A01_2021-Broken_Access_Control/
- https://owasp.org/API-Security/editions/2023/en/api8-security-misconfiguration/
- https://owasp.org/API-Security/editions/2023/en/api9-improper-inventory-management/
Research Provenance
Primary sources:
- OWASP Top 10:2021 A04/A01; OWASP API8/API9:2023 (accessed 2026-09-15)
Secondary / internal:
- AXGuard
/axguard-threat-model,/axguard-cso,/axguard-audit - AwareXone Agentic-Bug-Hunter architecture review methodology (concepts only; not copied)
Datasets:
- UVID HF dataset — category linkage concepts only (MIT license metadata review 2026-09-15)
In this repository39 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- ai-agent-securitySkill
- ai-application-securitySkill
- api-securitySkill
- attack-surface-mappingSkill
- authentication-analysisSkill
- authorization-analysisSkill
- axguard-auditSkill
- axguard-csoSkill
- axguard-knowledgeSkill
- axguard-preshipSkill
- axguard-remediateSkill
- axguard-reportSkill
- axguard-securitySkill
- axguard-triageSkill
- cloud-securitySkill
- command-injectionSkill
- configuration-securitySkill
- deserialization-securitySkill
- file-upload-securitySkill
- graphql-securitySkill
- jwt-securitySkill
- mcp-securitySkill
- oauth-securitySkill
- path-traversalSkill
- prompt-injectionSkill
- prototype-pollutionSkill
- secrets-detectionSkill
- security-remediationSkill
- security-triageSkill
- session-securitySkill
- sql-injectionSkill
- ssrf-analysisSkill
- ssti-analysisSkill
- supply-chain-securitySkill
- threat-modelingSkill
- websocket-securitySkill
- xss-analysisSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

