mirror of
https://github.com/github/awesome-copilot.git
synced 2026-05-01 12:45:56 +00:00
feat: Add Project Documenter Plugin with agents and skills (#1436)
* feat: Add Project Documenter Plugin with agents and skills - Auto-discovers technology stack and project structure - Generates architecture diagrams with draw.io - Creates professional Word (.docx) output with embedded PNG images - Includes agents for orchestration and skills for functionality * chore: moved agents, skills and scripts to respective folders * chore: ran npm run build for readme updates * Update plugins/project-documenter/.github/plugin/plugin.json Co-authored-by: Aaron Powell <me@aaron-powell.com> * fix: readme.agent.md file * fix: added the missing agent file and updated readme for the same --------- Co-authored-by: Aaron Powell <me@aaron-powell.com>
This commit is contained in:
parveen-dotnet
GitHub
28
plugins/project-documenter/.github/plugin/plugin.json
vendored
Normal file
28
plugins/project-documenter/.github/plugin/plugin.json
vendored
Normal file
@@ -0,0 +1,28 @@
|
||||
{
|
||||
"name": "project-documenter",
|
||||
"description": "Generate professional project documentation with draw.io architecture diagrams and Word (.docx) output with embedded images. Automatically discovers any project's technology stack and produces Markdown, diagrams, PNG exports, and a formatted Word document.",
|
||||
"version": "1.0.0",
|
||||
"author": {
|
||||
"name": "Awesome Copilot Community"
|
||||
},
|
||||
"repository": "https://github.com/github/awesome-copilot",
|
||||
"license": "MIT",
|
||||
"keywords": [
|
||||
"documentation",
|
||||
"architecture-diagrams",
|
||||
"drawio",
|
||||
"word-document",
|
||||
"docx",
|
||||
"png-images",
|
||||
"c4-model",
|
||||
"project-summary",
|
||||
"auto-discovery"
|
||||
],
|
||||
"agents": [
|
||||
"./agents/project-documenter.md"
|
||||
],
|
||||
"skills": [
|
||||
"./skills/drawio/",
|
||||
"./skills/md-to-docx/"
|
||||
]
|
||||
}
|
||||
126
plugins/project-documenter/README.md
Normal file
126
plugins/project-documenter/README.md
Normal file
@@ -0,0 +1,126 @@
|
||||
# Project Documenter Plugin
|
||||
|
||||
Generate professional project documentation with draw.io architecture diagrams and Word (.docx) output with embedded PNG images. Works on any software project — automatically discovers the technology stack, architecture, and code structure.
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
# Using Copilot CLI
|
||||
copilot plugin install project-documenter@awesome-copilot
|
||||
```
|
||||
|
||||
## What It Does
|
||||
|
||||
Point the **Project Documenter** agent at any repository and it produces:
|
||||
|
||||
1. **Markdown document** — 10-section project summary with embedded diagram references
|
||||
2. **Draw.io diagrams** — C4 Context, Pipeline, and Component relationship diagrams (`.drawio` + `.drawio.png`)
|
||||
3. **Word document** — professionally formatted `.docx` with title page, table of contents, and embedded PNG architecture images
|
||||
|
||||
## What's Included
|
||||
|
||||
### Agent
|
||||
|
||||
| Agent | Description |
|
||||
|-------|-------------|
|
||||
| `project-documenter` | Generates professional project documentation with draw.io architecture diagrams and Word document output with embedded images. Auto-discovers any project's technology stack and architecture. |
|
||||
|
||||
### Skills
|
||||
|
||||
| Skill | Description |
|
||||
|-------|-------------|
|
||||
| `drawio` | Generate draw.io diagrams as `.drawio` files and export to PNG via bundled Node.js script (uses draw.io CLI or headless browser) |
|
||||
| `md-to-docx` | Convert Markdown to Word (`.docx`) with embedded PNG images — pure JavaScript, no Pandoc required |
|
||||
|
||||
## How It Works
|
||||
|
||||
### Step 1: Discover
|
||||
|
||||
The agent scans your repository to understand:
|
||||
- Technology stack (`.csproj`, `package.json`, `pom.xml`, `go.mod`, etc.)
|
||||
- Architecture pattern (API, worker service, CLI, library)
|
||||
- Design patterns (factory, strategy, repository, pipeline)
|
||||
- Interfaces, implementations, models, configuration
|
||||
- Dependencies, Docker setup, CI/CD
|
||||
|
||||
### Step 2: Generate Diagrams
|
||||
|
||||
Creates 3-5 professional draw.io diagrams following the C4 Model:
|
||||
|
||||
| Diagram | C4 Level | Shows |
|
||||
|---------|----------|-------|
|
||||
| High-Level Architecture | Context | System in its environment — upstream, downstream, external deps |
|
||||
| Processing Pipeline | Container | Internal data flow — entry point → stages → output |
|
||||
| Component Relationships | Component | Interfaces, implementations, factories, DI graph |
|
||||
| Deployment (optional) | Infrastructure | Docker, Kubernetes, scaling, cloud services |
|
||||
| Data Model (optional) | Component | Entity/DTO hierarchy (if significant) |
|
||||
|
||||
Each diagram is exported to PNG using the bundled `drawio-to-png.mjs` script.
|
||||
|
||||
### Step 3: Write Markdown
|
||||
|
||||
Produces `docs/project-summary.md` with 10 sections:
|
||||
|
||||
1. Executive Summary
|
||||
2. Architecture Overview (with embedded diagram)
|
||||
3. Processing Pipeline (with embedded diagram)
|
||||
4. Core Components (with embedded diagram)
|
||||
5. API Contracts / Message Schemas
|
||||
6. Infrastructure & Deployment
|
||||
7. Extension Patterns
|
||||
8. Rules & Anti-Patterns
|
||||
9. Dependencies
|
||||
10. Code Structure
|
||||
|
||||
### Step 4: Word Document
|
||||
|
||||
Converts the Markdown to a formatted `.docx` using the bundled `md-to-docx.mjs` script:
|
||||
|
||||
- Title page with project name, date, version, audience
|
||||
- Auto-generated table of contents
|
||||
- **PNG diagram images embedded inline** in the Word document
|
||||
- Calibri font, colored headings, styled tables with alternating rows
|
||||
- Code blocks in Consolas with shaded background
|
||||
|
||||
### Step 5: Verify
|
||||
|
||||
Spot-checks class names, file paths, and diagram accuracy against the actual codebase. Reports all generated files.
|
||||
|
||||
## Generated Output
|
||||
|
||||
```
|
||||
docs/
|
||||
├── project-summary.md # Source document (Markdown)
|
||||
├── project-summary.docx # Word document with embedded images
|
||||
└── diagrams/
|
||||
├── high-level-architecture.drawio # C4 Context diagram (editable)
|
||||
├── high-level-architecture.drawio.png # Rendered PNG
|
||||
├── processing-pipeline.drawio # C4 Container diagram
|
||||
├── processing-pipeline.drawio.png
|
||||
├── component-relationships.drawio # C4 Component diagram
|
||||
└── component-relationships.drawio.png
|
||||
```
|
||||
|
||||
## Prerequisites
|
||||
|
||||
| Requirement | Purpose | Required? |
|
||||
|-------------|---------|-----------|
|
||||
| Node.js 18+ | Run bundled export scripts | Yes |
|
||||
| Edge or Chrome | Headless browser for diagram rendering | One of: this OR draw.io desktop |
|
||||
| draw.io desktop | CLI diagram export (faster alternative) | Optional (browser fallback available) |
|
||||
|
||||
## Technology Agnostic
|
||||
|
||||
Works with any stack. The agent auto-detects:
|
||||
- **.NET** (`.csproj`, `.sln`), **Java** (`pom.xml`, `build.gradle`), **Node.js** (`package.json`), **Python** (`pyproject.toml`), **Go** (`go.mod`), **Rust** (`Cargo.toml`)
|
||||
- Docker, Kubernetes, GitHub Actions, GitLab CI
|
||||
- Any messaging system (SQS, RabbitMQ, Kafka, Azure Service Bus)
|
||||
- Any database ORM (EF, Hibernate, Prisma, SQLAlchemy)
|
||||
|
||||
## Source
|
||||
|
||||
This plugin is part of [Awesome Copilot](https://github.com/github/awesome-copilot), a community-driven collection of GitHub Copilot extensions.
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
Reference in New Issue
Block a user