architecture-verify

Architecture Verification Subagent

Verifies codebase against architecture contract. Works with dependency graphs, not source code.

Overview

This subagent verifies the codebase adheres to the architecture contract by:

1. Extracting dependency graphs (cheap)
2. Checking against documented rules
3. Sampling files only to verify pattern conformance

Invocation

"Verify architecture health"
"Check for architecture violations"
"Verify resource pattern conformance"

Phase 1: Extract Dependency Graph

Run these commands to build the graph (zero tokens):

Lua Dependencies

# Core -> * dependencies
for f in lua/kubectl/*.lua; do
  echo "=== $f ==="
  grep "^local.*require" "$f" | sed 's/.*require("\([^"]*\)").*/\1/'
done

# Resources -> * dependencies
for f in lua/kubectl/resources/*/init.lua; do
  echo "=== $f ==="
  grep "^local.*require" "$f" | sed 's/.*require("\([^"]*\)").*/\1/'
done

# Views -> * dependencies
for f in lua/kubectl/views/*/init.lua; do
  echo "=== $f ==="
  grep "^local.*require" "$f" | sed 's/.*require("\([^"]*\)").*/\1/'
done

# Actions -> * dependencies
for f in lua/kubectl/actions/*.lua; do
  echo "=== $f ==="
  grep "^local.*require" "$f" | sed 's/.*require("\([^"]*\)").*/\1/'
done

Rust Dependencies

# Module -> module dependencies
for f in kubectl-client/src/*.rs; do
  echo "=== $f ==="
  grep "^use crate::" "$f" | sed 's/use crate::\([^:;{]*\).*/\1/'
done

Phase 2: Verify Against Contract

With the dependency graph extracted, check these rules:

Lua Rules to Verify

Rule	How to Check
Utils is leaf	No require in utils/*.lua that points outside utils
Client is leaf	No require in client/*.lua that points outside client
Resources don't cross-require	Resources only require base_resource, not other resources
Views don't require resources	No kubectl.resources.* in views/*/init.lua
Actions don't require resources	No kubectl.resources.* in actions/*.lua