chore: restructure skills repo with new agents and skill bundles
- Add new skills: deep-dive, docs-rag, meta-creator, ppt-maker, sdlc - Add agent configs: g-assistent, meta-creator, sdlc with prompt files - Add reference docs for custom agents and skills specification - Add utility scripts: install-agents.sh, orchestrate.py, puml2svg.sh - Update README and commit-message skill config - Remove deprecated skills: codereview, python, testing, typescript - Add .gitignore
This commit is contained in:
@@ -0,0 +1,143 @@
|
||||
# Deep Dive Report: {SUBJECT}
|
||||
|
||||
> Generated by the `deep-dive` skill.
|
||||
> Date: {DATE}
|
||||
> Source: {SOURCE}
|
||||
|
||||
---
|
||||
|
||||
## 1. Overview
|
||||
|
||||
- **What it is**:
|
||||
- **Problem it solves**:
|
||||
- **Target users**:
|
||||
- **Design philosophy**:
|
||||
- **Tech stack**:
|
||||
|
||||
---
|
||||
|
||||
## 2. Architecture
|
||||
|
||||
{description of high-level structure}
|
||||
|
||||
```plantuml
|
||||
@startuml
|
||||
' Replace with actual components
|
||||
package "Layer A" {
|
||||
[Component 1]
|
||||
}
|
||||
package "Layer B" {
|
||||
[Component 2]
|
||||
[Component 3]
|
||||
}
|
||||
[Component 1] --> [Component 2] : protocol
|
||||
[Component 2] --> [Component 3] : protocol
|
||||
@enduml
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Key Concepts & Terminology
|
||||
|
||||
**Term** — definition and why it matters in this system.
|
||||
|
||||
---
|
||||
|
||||
## 4. Data Model
|
||||
|
||||
{description of primary entities and relationships}
|
||||
|
||||
```plantuml
|
||||
@startuml
|
||||
entity EntityA {
|
||||
* id : UUID
|
||||
--
|
||||
field : Type
|
||||
}
|
||||
entity EntityB {
|
||||
* id : UUID
|
||||
--
|
||||
field : Type
|
||||
}
|
||||
EntityA ||--o{ EntityB : relationship
|
||||
@enduml
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Core Flows & Sequences
|
||||
|
||||
### Flow 1: {Name}
|
||||
|
||||
{one-paragraph description}
|
||||
|
||||
```plantuml
|
||||
@startuml
|
||||
actor User
|
||||
participant "Component A" as A
|
||||
participant "Component B" as B
|
||||
|
||||
User -> A : action
|
||||
A -> B : call
|
||||
B --> A : response
|
||||
A --> User : result
|
||||
@enduml
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Public API / Interface Reference
|
||||
|
||||
| Method | Path / Signature | Purpose | Key Params | Returns |
|
||||
|--------|-----------------|---------|------------|---------|
|
||||
| GET | /resource | description | param | type |
|
||||
|
||||
**Auth**: {mechanism}
|
||||
|
||||
---
|
||||
|
||||
## 7. Configuration & Deployment
|
||||
|
||||
**Key config options:**
|
||||
|
||||
| Variable | Default | Description |
|
||||
|----------|---------|-------------|
|
||||
| `ENV_VAR` | value | what it controls |
|
||||
|
||||
**Run locally:**
|
||||
```bash
|
||||
# minimal steps
|
||||
```
|
||||
|
||||
**Deployment topology**: {description}
|
||||
|
||||
---
|
||||
|
||||
## 8. Extension & Integration Points
|
||||
|
||||
- {plugin/hook/middleware description}
|
||||
- {how to add a new feature}
|
||||
- {external integration patterns}
|
||||
|
||||
---
|
||||
|
||||
## 9. Observability
|
||||
|
||||
- **Logging**:
|
||||
- **Metrics**:
|
||||
- **Tracing**:
|
||||
- **Health check**:
|
||||
|
||||
---
|
||||
|
||||
## 10. Known Limitations & Trade-offs
|
||||
|
||||
- {limitation or trade-off}
|
||||
|
||||
---
|
||||
|
||||
## 11. Further Reading
|
||||
|
||||
1. **[Topic]** — why it matters and where to find it
|
||||
2. **[Topic]** — why it matters and where to find it
|
||||
3. **[Topic]** — why it matters and where to find it
|
||||
Reference in New Issue
Block a user