SpillwaveSolutions/document-specialist-skill / skills/documentation-specialist
documentation-specialist
VerifiedThis skill should be used when creating professional software documentation (SRS, PRD, OpenAPI, SDD, architecture docs, user manuals, tutorials, runbooks) from templates (greenfield) or reverse-engineering documentation from existing code like Spring Boot or FastAPI (brownfield). Also handles documentation audits/reviews, format conversion (Markdown, DOCX, PDF), and diagram generation (Mermaid first: C4, sequence, class, ER, state, flowchart; PlantUML Salt for UI wireframes and leftover UML). Use when asked to "create documentation", "document my code", "write SRS", "generate PRD", "write DESIGN_DOC.md", "architecture document", "wireframe", or "documentation specialist".
references/workflows/brownfield/pulumi-guide.md
View on GitHub# Pulumi Code-to-Docs Guide
---
TOKEN_BUDGET: 250
TIER: 3
LOAD_TRIGGER: CODE_TO_DOCS + Pulumi detected
DEPENDENCIES: brownfield-workflow.md
---
## Detection
```
Glob: "Pulumi.yaml"
Grep: "import pulumi"
```
## Extraction Commands
### Network Resources
```
Grep: "pulumi.aws.ec2.Vpc" → VPC configuration
Grep: "pulumi.aws.ec2.Subnet" → Subnets
Grep: "pulumi.aws.ec2.NatGateway" → NAT
Grep: "pulumi.aws.ec2.InternetGateway" → IGW
```
### Compute Resources
```
Grep: "pulumi.aws.ecs.Cluster" → ECS clusters
Grep: "pulumi.aws.ecs.Service" → ECS services
Grep: "pulumi.aws.ec2.Instance" → EC2 instances
Grep: "pulumi.aws.lambda.Function" → Lambda
```
### Data Resources
```
Grep: "pulumi.aws.rds.Instance" → RDS databases
Grep: "pulumi.aws.dynamodb.Table" → DynamoDB
Grep: "pulumi.aws.s3.Bucket" → S3 buckets
```
### Security Resources
```
Grep: "pulumi.aws.ec2.SecurityGroup" → Security groups
Grep: "pulumi.aws.iam.Role" → IAM roles
Grep: "pulumi.aws.iam.Policy" → IAM policies
```
### CDN/Edge
```
Grep: "pulumi.aws.cloudfront.Distribution" → CloudFront
Grep: "pulumi.aws.route53" → DNS
```
## Output Files
| Artifact | Location | Content |
|----------|----------|---------|
| Infrastructure Doc | `docs/deployment/{project}-infrastructure.md` | Full architecture |
| C4 Diagram | `docs/diagrams/infrastructure-c4.md` | System overview |
| Deployment Diagram | `docs/diagrams/deployment-topology.puml` | AWS resources |
## Document Structure
1. **Network Architecture**
- VPC CIDR blocks
- Public/private subnets
- NAT Gateway configuration
2. **Compute Layer**
- ECS clusters and services
- Task definitions
- Auto-scaling config
3. **Data Layer**
- RDS configuration
- S3 buckets and policies
4. **Security**
- Security group rules
- IAM roles and policies
5. **Cost Estimation** (optional)
- Resource costs by category
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |