skills.rest
ArtyMcLabin
ArtyMcLabinCOMMUNITY
Explore all skills by this author →
Website𝕏@Arty_McLabinGitHub

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
One-click install
npx skills add https://github.com/ArtyMcLabin/ClaudeCode-global-config --skill knowledge-architecture
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Education & Research Skills→
cshyangcshyang

gsd:init-repo

Initialize a GSD repository structure with Git and planning documents.

Community
Intermediate
pradyumnasagarpradyumnasagar
6

roadmap-author

Guide authors through creating and validating ORS SKILL.md files.

Community
Intermediate
mrvladd-dmrvladd-d
53

mb-garden

Lint Memory Bank frontmatter, links, and router indexes.

Community
Intermediate
1cFE1cFE
6

project-structure

Organize SysML projects into knowledge, modeling_project, work, and data directories.

Official
Intermediate