{
  "markdown": "# CSitRep Generator\n\nMulti-agent Situation Report generator for Claude Code. Dispatches 25 specialist AI agents to analyze your project documents and produces actionable status reports with interactive dashboards.\n\nSupports **6 project types**: Construction, Software/IT, Development Programs, Product/Manufacturing, Consulting, and Custom.\n\n## How It Works\n\n1. Drop project documents into organized data folders\n2. Run `/csitrep-generator:generate`\n3. Five domain-specialist agents analyze your documents in parallel\n4. The system synthesizes findings into a structured report with critical issues, watch items, and recommended actions\n5. Optionally delivers to Slack and generates an interactive HTML dashboard\n\nEach agent classifies findings as **CRITICAL** (needs decision today), **WATCH** (trending negative), or **ON TRACK** (within tolerance).\n\n## Installation\n\n```bash\n/plugin install chiKeka/csitrep-generator\n```\n\nRestart Claude Code after installation for skills to load.\n\n### Requirements\n\n- Claude Code (Pro, Max, Teams, or Enterprise)\n\n### Optional (for Office file conversion)\n\n```bash\nbrew install pandoc\npip3 install pandas openpyxl python-docx python-pptx xlrd\n```\n\nOffice files (.xlsx, .docx, .pptx) are auto-converted on session start. PDF, CSV, TXT, JSON, XML, YAML, and images work natively.\n\n## Quick Start\n\n```\n/csitrep-generator:setup          # Configure your project\n# Drop documents into data folders\n/csitrep-generator:generate       # Generate your first report\n```\n\nNew to the plugin? Run `/csitrep-generator:onboard` for a step-by-step walkthrough.\n\n## Commands\n\n### Core\n\n| Command | Description |\n|---------|-------------|\n| `/csitrep-generator:generate` | Generate a full Situation Report |\n| `/csitrep-generator:dashboard` | Quick one-line status per domain |\n| `/csitrep-generator:dashboard-ui` | Interactive HTML dashboard |\n| `/csitrep-generator:compare` | Compare reports and identify trends |\n\n### Setup & Configuration\n\n| Command | Description |\n|---------|-------------|\n| `/csitrep-generator:setup` | Configure a new project |\n| `/csitrep-generator:team-setup` | One-stop admin setup (project + Slack + schedule) |\n| `/csitrep-generator:onboard` | Guided walkthrough for new users |\n| `/csitrep-generator:import` | Import from Jira, Procore, MS Project, Monday.com, Asana, Smartsheet |\n| `/csitrep-generator:validate` | Check data quality before generating |\n\n### Tracking\n\n| Command | Description |\n|---------|-------------|\n| `/csitrep-generator:track-risks` | Manage project risk register |\n| `/csitrep-generator:track-actions` | Track action items across reports |\n| `/csitrep-generator:track-changes` | Log and analyze change orders |\n| `/csitrep-generator:feedback` | Flag incorrect findings for future improvement |\n\n### Automation\n\n| Command | Description |\n|---------|-------------|\n| `/csitrep-generator:schedule` | Set up recurring report generation (daily/weekly/monthly) |\n\n## Project Types and Domains\n\n### Construction\nSchedule, Cost & Budget, Safety, Contracts & Admin, Site Conditions\n\n### Software/IT\nSprint & Roadmap, Budget & Resources, Quality & Testing, Dependencies & Blockers, Infrastructure & DevOps\n\n### Development Programs\nWorkplan & Timeline, Budget & Grants, M&E, Stakeholders & Partners, Field Operations\n\n### Product/Manufacturing\nDevelopment Timeline, Cost & Procurement, Quality & Compliance, Supply Chain, Production & Operations\n\n### Consulting\nDeliverables & Timeline, Budget & Billing, Client Satisfaction, Resource Allocation, Risk & Issues\n\n### Custom\nDefine your own 5 domains with custom agent definitions generated during setup.\n\n## Data Folder Structure\n\nAfter setup, your project data folders are created based on project type. For example, a construction project:\n\n```\ndata/\n├── config/\n│   └── project-info.json    # Project configuration\n├── schedule/                # Baseline schedules, daily logs, look-aheads\n├── cost/                    # Budget vs actual, change orders, invoices\n├── safety/                  # Incident reports, inspections, corrective actions\n├── contracts/               # RFIs, submittals, meeting minutes\n├── site/                    # Field reports, weather logs, equipment logs\n└── archive/                 # Timestamped snapshots (auto-created)\n```\n\nDrop any combination of PDF, CSV, Excel, Word, PowerPoint, images, or text files into the relevant folders.\n\n## Output\n\nReports are saved to `output/csitrep/`:\n\n- `YYYY-MM-DD-sitrep.md` — Full markdown report\n- `YYYY-MM-DD-dashboard.html` — Interactive HTML dashboard (self-contained, no dependencies)\n\n### Report Sections\n\n1. Executive Summary\n2. KPI Summary (Critical / Watch / On Track counts + key metrics)\n3. Domain Status Summaries (status + metrics + findings per domain)\n4. Critical Issues (numbered, with domain and impact)\n5. Watch Items\n6. Recommended Actions (owner, due date, priority)\n7. Period-over-Period Trends (if prior reports exist)\n8. Risk Summary\n9. Open Actions Status\n\n### HTML Dashboard\n\nProfessional consulting-style layout with:\n- KPI indicator row\n- Domain status cards with metrics\n- Critical issues and watch items tables\n- SVG trend charts (when quantitative data is available)\n- Search/filter, collapsible sections, print-to-PDF optimization\n\n## Slack Integration\n\nConfigure during setup to auto-deliver reports to a Slack channel. The plugin uses MCP Slack integration:\n- Full report posted to channel\n- Critical items highlighted with mentions\n- Team members can reply in-thread with feedback\n- Dashboard link included\n\n## Automation\n\nSet up recurring reports with `/csitrep-generator:schedule`:\n- **Daily**: Weekdays at 4 PM\n- **Weekly**: Friday at 4 PM\n- **Monthly**: 1st of month at 9 AM\n- **Custom**: Provide your own cron expression\n\nOnly the admin needs Claude Code installed. The team receives reports via Slack.\n\n## Importing from PM Tools\n\nThe `/csitrep-generator:import` command supports:\n\n- Jira (CSV/JSON export)\n- MS Project (.mpp/.xml export)\n- Primavera P6 (.xer/.xml export)\n- Procore (report exports)\n- Monday.com (CSV export)\n- Asana (CSV export)\n- Smartsheet (Excel export)\n\nThe import maps exported data to the correct data folders and saves the mapping for recurring imports.\n\n## Architecture\n\nThe plugin uses a multi-agent architecture with 25 specialist agents (5 per project type) orchestrated by the generate skill:\n\n1. **Preprocessing** — Office files converted to readable formats\n2. **Archiving** — Current data snapshot preserved for version history\n3. **Validation** — Data folders checked for content\n4. **Parallel Dispatch** — All 5 domain agents run simultaneously\n5. **Synthesis** — Findings merged into structured report with trend analysis\n6. **Delivery** — Report saved and optionally posted to Slack\n\n## License\n\nMIT\n",
  "bytes": 6762,
  "sha": "c7494f7fb039d01d10d9e9985f3371ca3bb58672a1410c545174e1e43a100f17",
  "repo_slug": "chikeka/csitrep-generator",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_chikeka_csitrep_generator_csitrep_genera_c7d1a9f6/readme"
}