harness-architecture-boundaries

Designs and audits layered architecture dependency rules via read-only Grep and Bash checks.

Updated Jun 18, 2026
One-click install
npx skills add https://github.com/zhengguangli/harness-engineering-kit --skill harness-architecture-boundaries-zhengguangli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: harness-architecture-boundaries
Source: https://github.com/zhengguangli/harness-engineering-kit/tree/main/skills/harness-architecture-boundaries
Command: npx skills add https://github.com/zhengguangli/harness-engineering-kit --skill harness-architecture-boundaries-zhengguangli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? In repositories where agents generate code at high throughput, architectural constraints that are not mechanically enforced get violated quickly — circular dependencies, cross-layer imports, and unparsed external data creep in. This Skill establishes layered architecture rules and audits them with a read-only boundary-auditor agent. ## Core Features & Use Cases - Layering Model Design: Derives a project-specific dependency direction (e.g., Types → Config → Repo → Service → Runtime → UI) with cross-cutting concerns funneled through a single Providers chokepoint, documented in docs/ARCHITECTURE.md. - Mechanical Boundary Audits: The boundary-auditor agent uses Grep/Bash to detect circular dependencies, cross-layer violations, and data boundary violations, producing a severity-classified report (CRITICAL/HIGH/MEDIUM/LOW) with actionable fix instructions. - Parse, Don't Validate Enforcement: Requires external data entering system boundaries to be parsed into strong types rather than passed around as any/dict. - Use Case: A team notices Service-layer files directly importing Repository implementations. Run this Skill to confirm the dependency rules, grep for violations, and receive a report with file line numbers and concrete refactoring steps. ## Quick Start Ask the agent to audit this repository for cross-layer dependency violations and circular dependencies, then generate an architecture boundary report with fix suggestions.

Frequently Asked Questions about harness-architecture-boundaries

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect circular dependencies in a codebase?▼

Use the boundary-auditor agent to search inter-module import statements with Grep and generate a dependency graph, or run tools like madge --circular. Circular dependency paths are marked CRITICAL in the audit report and block merge until fixed.

How to enforce layered architecture without a lint toolchain?▼

The boundary-auditor agent performs inline checks using Grep, Glob, and Bash — no pre-configured lint setup is required. It searches for cross-layer import patterns defined in docs/ARCHITECTURE.md and reports violations with fix suggestions.

What is the Parse, Don't Validate rule for data boundaries?▼

External data entering the system boundary must be parsed into strong types rather than validated and passed as any or dict. The audit checks boundary-layer files for any type annotations, type assertions, and raw response objects passed downstream.

When should I not use architecture boundary enforcement?▼

Skip it for very small projects with no clear layering need, pure style preference issues like naming or import ordering (handled by periodic cleanup skills), or when the team explicitly does not want architectural constraints.

How are architecture violations classified by severity?▼

CRITICAL covers circular dependencies and cross-layer violations that block merge. HIGH covers scattered cross-cutting concerns and data boundary violations. MEDIUM records ambiguous rules as architecture debt, and LOW items go to periodic cleanup.