harness-architecture-checks

Propose executable architecture boundary checks from project documentation and directory layout.

Updated Jul 29, 2026
One-click install
npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill harness-architecture-checks-maicongambini
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-architecture-checks
Source: https://github.com/MaiconGambini/opencode-harness-guide/tree/main/skills/harness-architecture-checks
Command: npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill harness-architecture-checks-maicongambini

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Architecture boundaries erode over time as codebases grow: frontend code starts importing backend internals, secrets leak into client bundles, and route handlers bypass service layers. This Skill turns existing architecture documentation and directory structure into concrete, executable boundary checks before drift becomes a production incident. ## Core Features & Use Cases - Evidence-Based Check Proposals: Generates boundary checks only from observed evidence in docs/ARCHITECTURE.md, root instructions, directory layout, and existing lint/test/CI configuration. - Common Boundary Patterns: Covers cross-layer import prevention, server-only secret isolation, route-to-service separation, domain independence from UI, and shared package purity. - Approval-Gated Script Generation: Outputs a structured proposal (boundary, evidence, script target, false-positive risk) and never writes check scripts without explicit approval. - Use Case: A team notices a client bundle accidentally imported a server-only module. Use this Skill to inspect the repository layout and propose a CI check that blocks browser code from importing server internals. ## Quick Start Ask the agent to analyze this repository's architecture docs and directory layout and propose executable boundary checks for cross-layer imports and secret leaks.

Frequently Asked Questions about harness-architecture-checks

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

FAQPage Schema
How do I prevent frontend code from importing backend internals?

Define an architecture boundary check that inspects import statements in frontend packages and fails when they reference backend-internal paths. This Skill proposes such checks based on your actual directory layout and existing lint or CI configuration, targeting a script or existing linter.

How to detect secret leaks into client-side code before deployment?

Add a boundary check that blocks browser or client code from importing server-only modules containing secrets. The Skill proposes this check with evidence from your package boundaries and flags false-positive risk before any script is written.

What should I do if my project has no architecture documentation?

When docs/ARCHITECTURE.md is missing, the Skill recommends establishing a context layer first rather than guessing boundaries. Checks are only generated from observed evidence, so undocumented architectures require documentation before reliable checks can be proposed.

Does this Skill write and run architecture check scripts automatically?

No. The Skill only produces a structured proposal describing the boundary, evidence, script target, and false-positive risk. Writing any check script requires explicit approval, and inspection commands are preferred over custom scripts.

What are the limitations of evidence-based architecture checks?

Checks are only as good as the available evidence: missing docs, unclear package boundaries, or absent CI configuration limit what can be proposed. Each proposal includes an evidence field that may report unknown when the layout does not support a definitive check.