infer-logical-architecture-from-code

Infer a technology-agnostic logical architecture from codebase scan signals.

3|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/kapilvirenahuja/garura --skill infer-logical-architecture-from-code
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: infer-logical-architecture-from-code
Source: https://github.com/kapilvirenahuja/garura/tree/main/core/components/skills/infer-logical-architecture-from-code
Command: npx skills add https://github.com/kapilvirenahuja/garura --skill infer-logical-architecture-from-code

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns a codebase scan signal set into a deterministic, technology-agnostic logical architecture proposal, so teams can bootstrap a bounded-context and capability view during brownfield codification without inventing physical implementation details.

Core Features & Use Cases

  • Infer bounded contexts from scan evidence: Derives candidate bounded contexts from repository/module structure, idioms, co-change signals, and entry points while keeping boundaries grounded in scan-index data.
  • Derive components, responsibilities, and capability coverage: Infers component roles and component-to-capability serving relationships only for the selected capability universe, flagging coverage gaps for review.
  • Build a logical architecture artifact with validation guardrails: Produces a complete logical-architecture output (topology claim, data model entities + relationships, capability-level API surface, integration points, ADR log), then enforces an abstraction-layer scrub to prevent leaking physical/implementation details.

Quick Start

Run infer-logical-architecture-from-code during /codify with scan-index.json plus the prior scope, enriched-capabilities, and features proposals to generate logical-architecture.yaml in the codify evidence location for tech-architect validation.

Frequently Asked Questions about infer-logical-architecture-from-code

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

FAQPage Schema
How do I reverse-engineer a logical architecture from an existing codebase?

You reverse-engineer a logical architecture by deriving bounded contexts, components, and integration points from codebase scan signals and prior enriched capability proposals. This produces a technology-agnostic topology using repository structure and co-change signals without inventing physical implementation details.

What is a bounded context and how do I identify them during brownfield codification?

Bounded contexts are logical system boundaries derived from repository structure, idioms, co-change signals, and entry points. During brownfield codification, you identify them by analyzing scan-index data to keep architectural boundaries grounded in actual codebase evidence.

How do I generate a technology-agnostic architecture artifact from source code?

You generate a technology-agnostic architecture artifact by scanning codebase signals and applying an abstraction-layer scrub to block physical, protocol, SDK, and schema-token leakage. This yields a logical architecture containing data entities, capability APIs, and integration points.

Do I need prior codify proposals to infer a logical architecture from code?

Yes, you need scan-index.json and prior scope, enriched-capabilities, and features proposals to infer a logical architecture. These inputs validate component roles and capability serving relationships, while optionally leveraging an architecture-inference stepping stone.

Why does my logical architecture inference leak physical implementation details?

Logical architecture inference leaks physical details when the abstraction-layer scrub fails to enforce strict validation against knowledge-patterns. Blocking physical, protocol, SDK, and schema-token leakage ensures the derived bounded contexts remain technology-agnostic.