Files
awesome-copilot/skills/acquire-codebase-knowledge/assets/templates/ARCHITECTURE.md
Satya K b8f3822748 Adds a new Agent Skill - Acquire-Codebase-Knowledge (#1373)
* feat(skill): add acquire-codebase-knowledge skill documentation

* feat(templates): add architecture, concerns, conventions, integrations, stack, structure, and testing documentation templates

* feat(references): add inquiry checkpoints and stack detection documentation

* feat(scan): add script to collect project discovery information for acquire-codebase-knowledge skill

* feat(skills): add acquire-codebase-knowledge skill for codebase mapping and documentation

* feat(scan): enhance scan script with absolute path handling and improved output variable validation

* feat(scan): replace bash script with Python script for project discovery information collection

* feat(skills): update acquire-codebase-knowledge skill to replace scan.sh with scan.py
2026-04-14 10:29:57 +10:00

1.2 KiB

Architecture

Core Sections (Required)

1) Architectural Style

  • Primary style: [layered/feature/event-driven/other]
  • Why this classification: [short evidence-backed rationale]
  • Primary constraints: [2-3 constraints that shape design]

2) System Flow

[entry] -> [processing] -> [domain logic] -> [data/integration] -> [response/output]

Describe the flow in 4-6 steps using file-backed evidence.

3) Layer/Module Responsibilities

Layer or module Owns Must not own Evidence
[name] [responsibility] [non-responsibility] [file]

4) Reused Patterns

Pattern Where found Why it exists
[singleton/repository/adapter/etc] [path] [reason]

5) Known Architectural Risks

  • [Risk 1 + impact]
  • [Risk 2 + impact]

6) Evidence

  • [path/to/entrypoint]
  • [path/to/main-layer-files]
  • [path/to/data-or-integration-layer]

Extended Sections (Optional)

Add only when needed:

  • Startup or initialization order details
  • Async/event topology diagrams
  • Anti-pattern catalog with refactoring paths
  • Failure-mode analysis and resilience posture