mirror of
https://github.com/github/awesome-copilot.git
synced 2026-04-15 20:55:55 +00:00
b8f3822748
* 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
50 lines
1.2 KiB
Markdown
50 lines
1.2 KiB
Markdown
# 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
|
|
|
|
```text
|
|
[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
|