architecture-guard

Validate file placements against .context/architecture.md rules.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/KaiBoo404/agent-skills-with-project-template --skill architecture-guard-kaiboo404
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-guard
Source: https://github.com/KaiBoo404/agent-skills-with-project-template/tree/main/.agents/skills/architecture-guard
Command: npx skills add https://github.com/KaiBoo404/agent-skills-with-project-template --skill architecture-guard-kaiboo404

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates that new files and modules are placed according to the architecture rules defined in .context/architecture.md, preventing architectural drift and misplacements.

Core Features & Use Cases

  • Reads .context/architecture.md to understand module boundaries, responsibilities, and import rules
  • Classifies a proposed file path into the correct module based on its purpose and placement
  • Enforces placement and import constraints during file creation, moves, and reviews

Quick Start

Ask architecture-guard to validate the proposed file path before creating or moving code.

Frequently Asked Questions about architecture-guard

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

FAQPage Schema
How do I validate file placement against my architecture rules?

You can enforce architecture rules by validating new file paths against .context/architecture.md. The Skill classifies the target module, checks path conformance and import restrictions, and returns a clear approval or rejection before code is written.

How do I prevent architectural drift when creating new modules?

Preventing architectural drift requires validating file placement during creation, moves, and code reviews. The Skill reads your architecture.md, classifies the proposed file into the correct module, and rejects misplacements before they enter your codebase.

Can I enforce module import restrictions during code reviews?

Yes, you can enforce import restrictions during code reviews by validating the target file path. The Skill checks the proposed placement against module boundaries and import rules defined in architecture.md, returning a clear rejection for any violations.

What is the best way to guard module boundaries before writing code?

The best way to guard module boundaries is to validate proposed file paths against architecture.md before creation. This pre-check classifies the target module, enforces placement rules, and stops misplacements before any code is actually written.

Do I need a specific file to validate module path conformance?

Yes, you need a .context/architecture.md file to validate path conformance. The Skill reads this file to understand module boundaries, responsibilities, and import rules required to classify and approve target file placements.

When should I validate file moves to avoid breaking architecture?

You should validate file moves before executing them to avoid breaking architecture. The Skill checks the proposed destination path against architecture.md, ensuring the new placement and its imports conform to module boundaries.