gxpm-architecture

Identify architectural deepening opportunities in codebases using CONTEXT.md vocabulary and ADRs.

1|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/laozhong86/gxpm --skill gxpm-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gxpm-architecture
Source: https://github.com/laozhong86/gxpm/tree/main/skills/gxpm-architecture
Command: npx skills add https://github.com/laozhong86/gxpm --skill gxpm-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Identify architectural friction in a codebase and surface opportunities to deepen modules using the CONTEXT.md domain vocabulary and ADRs, enabling more testable, AI-navigable architectures.

Core Features & Use Cases

  • Surface architectural friction across modules and seams to guide targeted refactoring.
  • Use CONTEXT.md vocabulary and ADRs to maintain domain alignment and governance.
  • Produce a prioritized set of deepening opportunities with problem statements, dependencies, and expected benefits.

Quick Start

Identify deepening opportunities by reviewing CONTEXT.md and ADRs for the touched area and present a ranked list of candidates.

Frequently Asked Questions about gxpm-architecture

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

FAQPage Schema
How do I identify architectural deepening opportunities during a codebase refactor?

To identify architectural deepening opportunities during a codebase refactor, evaluate modules for depth and seams using CONTEXT.md vocabulary and ADRs. This surfaces friction points to reduce coupling and improve testability, outputting structured candidates with impacted files and expected benefits.

What is architectural deepening in the context of reducing module coupling?

Architectural deepening is the process of evaluating modules for depth and seams to reduce coupling and improve testability. It uses domain vocabulary from CONTEXT.md to maintain alignment, producing a prioritized set of refactoring candidates with problem statements and dependency handling recommendations.

Can I use ADRs to guide targeted refactoring and improve codebase testability?

Yes, you can use ADRs to guide targeted refactoring by evaluating architectural friction across modules and seams. This approach maintains domain governance and produces prioritized deepening opportunities that improve testability and AI-navigability with clear problem statements and dependencies.

How do I assess codebase architecture to enhance AI-navigability?

Assess codebase architecture to enhance AI-navigability by reviewing CONTEXT.md and ADRs to surface architectural friction. This evaluation identifies modules lacking depth, generating a ranked list of refactoring candidates with impacted files and recommended dependency handling to improve navigability.

What is the best way to find architectural friction across modules and seams?

The best way to find architectural friction across modules and seams is to analyze the codebase using CONTEXT.md domain vocabulary and ADRs. This surfaces targeted refactoring opportunities, providing structured outputs with problem statements, dependencies, and expected benefits to reduce coupling.