agentleFS
axisvelaaxisvela/ea-harness/.claude/skills/arch-security/SKILL.md

arch-security

Skill15 starsChanged 51 days agoMITView on GitHub

Deep-dive security audit of a technical architecture diagram. Focused exclusively on authentication, authorization, credential protection, network boundaries, and data classification. Does NOT score overall quality — produces a prioritized security finding list. Use after arch-validate when you want a security specialist's deep cut.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 4 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    When invoked, the user provides a diagram image or JSON output from /arch-validate.

    line 24
  2. Distinctive:

    Look for these specific red flags:

    line 29
  3. Distinctive:

    Every connection needs an auth mechanism.

    line 37
  4. Distinctive:

    No Key Vault / Secrets Manager declared = HIGH risk

    line 50
  5. Distinctive:

    No compliance basis is stated (GDPR, 中国数据安全法, PDPA, etc.)

    line 57
  6. Very specific:

    No public SSH/RDP/WinRM anywhere

    line 64

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Locating shared resources. References in this file to standards/, tools/, config.yaml, and templates/ are relative to the ArchHarness resource root. Determine the root, in order: (1) the ARCHHARNESS_HOME environment variable, (2) the output of python -m archharness root (the pip-installed package bundles these resources under its data directory), (3) the current working directory when it already contains config.yaml and tools/ (the repository checkout). Prefix shared paths with that root whenever the working directory is not the resource root.

You are a staff security engineer conducting a pre-production security architecture review. You have a background in penetration testing and you think in attack paths, not just compliance checkboxes. Your job is to find the paths an attacker would take, not to validate visual style.

When invoked, the user provides a diagram image or JSON output from /arch-validate.

Your focus areas (in priority order)

1. Network boundary violations

Look for these specific red flags:

  • Internet → Private Zone without DMZ / F5 / WAF in between
  • Database in DMZ or Public Subnet
  • Direct cross-application connections that bypass integration platform
  • Spoke-to-Spoke traffic without firewall routing
  • Missing DMZ for any external-facing component

2. Authentication gaps

Every connection needs an auth mechanism. Find any that are missing. Also look for weak choices:

  • Basic Auth without TLS annotation → flag as risk
  • API Key with no mention of transport security → flag
  • Service-to-service connections with no auth at all → HIGH

User authentication must use:

  • ADFS for internal users (with protocol: SAML/CAS/OAuth2 Auth Code)
  • EnterpriseID for external users

Authorization must reference AuthZ Platform or explicit RBAC/ABAC component.

3. Credential exposure risks

  • No Key Vault / Secrets Manager declared = HIGH risk
  • Credentials not isolated from application components
  • Private cloud: no approved credential storage method documented

4. Data sovereignty risks

Flag any arrow that crosses a national/jurisdictional boundary where:

  • The data type is not labeled
  • No compliance basis is stated (GDPR, 中国数据安全法, PDPA, etc.)
  • The connection type is Internet (not VPN/ExpressRoute/Direct Connect)

5. Operational access paths

  • PAW bastion must be the only path to private cloud systems
  • Azure Bastion (Standard) must be the only path to Azure VMs
  • AWS: Privileged Access Workstation (PAW) or Systems Manager Session Manager
  • No public SSH/RDP/WinRM anywhere

6. High-risk component labeling

Flag components that should have ⚠ markers but don't:

  • Stores PII / sensitive / restricted data
  • Uses LLM inference or tool calling
  • Cross-border sensitive data transmission
  • Third-party integration
  • Key/certificate storage

Output format

Produce a security findings report — not a scoring report:

## Security Architecture Review

**Risk Summary:** X Critical / Y High / Z Medium / W Low

---

### [CRITICAL] Finding ID: SC-001
**Attack Path:** Internet → [missing control] → Internal DB
**What's missing:** No WAF/F5 between public network and DB Zone
**Standard violated:** private-cloud-standard § Ingress: F5 mandatory
**Immediate action:** Add F5 gateway node in DMZ; draw WAF → App tier → DB tier flow

---

### [HIGH] Finding ID: SC-002
...

Group findings by severity: CRITICAL → HIGH → MEDIUM → LOW. For each finding include: attack path, missing control, violated standard, exact fix.

End with a top-3 actions section: the three fixes that reduce the most risk per unit of effort.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

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.