knowledge-architecture

Route knowledge to SKILL.md, CLAUDE.md, reference-data, or agent repositories.

8|1|Updated Aug 5, 2025

Search Tags:#documentation #governance #CLAUDE.md #SOP #knowledge-management #knowledge-architecture

Ready to run

npx skills add https://github.com/ArtyMcLabin/ClaudeCode-global-config --skill knowledge-architecture

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: knowledge-architecture
Source: https://github.com/ArtyMcLabin/ClaudeCode-global-config/tree/main/skills/knowledge-architecture
Command: npx skills add https://github.com/ArtyMcLabin/ClaudeCode-global-config --skill knowledge-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured framework for knowledge management in Claude Code projects, guiding decisions on where to store new knowledge (skill vs CLAUDE.md vs reference-data vs agent), routing information, and SOP placement, while maintaining CLAUDE.md hygiene.

Core Features & Use Cases

Guidelines for placing information (skill, CLAUDE.md, reference-data, or agent repositories) and deciding when to create new skills or agents.
Pointer registry patterns to minimize context bloat while preserving actionable pointers.
Enforcement of skill structure, frontmatter hygiene, and workflow best practices for edits to CLAUDE.md or related docs.
Documentation governance for SOPs, knowledge architecture decisions, and documentation structure.

Quick Start

Review a draft CLAUDE.md or SOP change for knowledge-architecture compliance before proposing edits.

Frequently Asked Questions about knowledge-architecture

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

FAQPage Schema

How do I organize Claude Code knowledge and SOPs across different project files?▼

Knowledge architecture in Claude Code involves routing information to the correct storage type—SKILL.md, CLAUDE.md, reference-data, or agent repositories—based on documentation governance and standard operating procedures.

When should I create a new skill versus adding to CLAUDE.md?▼

Create a new skill or agent when handling distinct workflows, while using CLAUDE.md for project-level pointers and hygiene. This separation minimizes context bloat and preserves actionable documentation.

What is the best way to maintain CLAUDE.md hygiene during edits?▼

Maintaining CLAUDE.md hygiene requires enforcing required frontmatter, proper skill structure, and pointer registry patterns before proposing edits to ensure documentation remains clean and actionable.

How do I manage SOP placement and documentation structure in Claude Code?▼

SOP placement follows documentation governance rules that guide where standard operating procedures are stored, ensuring workflow information is routed correctly within your knowledge architecture.

Can I use pointer registry patterns to reduce context bloat in Claude Code projects?▼

Pointer registry patterns minimize context bloat by storing concise references instead of full content, preserving actionable pointers within CLAUDE.md while keeping the active context window clean.

Does knowledge architecture enforcement work without existing SOPs or documentation frameworks?▼

Knowledge architecture enforcement applies best when you have draft CLAUDE.md or SOP changes ready for compliance review, providing the structural framework to validate frontmatter and skill organization.