Windsurf + Aider targets, MCP server, and demo placement (#33)

Broadens both reach (more tools) and content types (an MCP server), continuing the multi-platform story. Windsurf + Aider: - build-exports.mjs gains two platforms: exports/windsurf/*.md (workspace rules, trigger: model_decision) and exports/aider/*.md (conventions for `aider --read`). Now 5 platforms (ChatGPT, Gemini, Cursor, Windsurf, Aider). - install.sh + bin/cli.mjs install both (windsurf -> .windsurf/rules, aider -> .aider/skills with a --read hint); generated README index is excluded from copies. - One-line windsurf-install.sh / aider-install.sh wrappers for parity. MCP server (new content type): - mcp/server.mjs — zero-dependency stdio MCP server exposing list_skills, search_skills, get_skill. Published as a second bin (pm-claude-skills-mcp). Logs to stderr; reads bundled skills/ at startup. mcp/README.md documents client config. Also: README hero "See it in action" demo placement (ready to swap in a GIF; recording guide in web/docs-assets/README.md), Works-With table + exports + install docs updated, CHANGELOG Unreleased. package.json files/bin updated. Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px Co-authored-by: Claude <noreply@anthropic.com>
2026-06-17 23:15:38 +01:00
parent 123aabe5e3
commit 036511ab3e
358 changed files with 60408 additions and 38 deletions
@@ -0,0 +1,125 @@
+---
+trigger: model_decision
+description: "Write a structured project status report for any project. Use when asked to write a project update, status report, RAG report, project dashboard narrative, or weekly project communication. Produces a clear status report with RAG ratings, milestone progress, risks, and decisions needed."
+---
+
+# Project Status Report Skill
+
+Produces a clear, structured project status report — the weekly communication that keeps stakeholders informed without requiring a meeting.
+
+## Required Inputs
+- **Project name**
+- **Reporting period**
+- **Current RAG status** (Red / Amber / Green)
+- **Key milestones** (due, delivered, coming)
+- **Issues or blockers**
+- **Decisions needed from stakeholders**
+- **Budget status** (if tracked)
+- **Audience** (steering committee / sponsor / PMO / full team)
+
+## Output Structure
+
+---
+
+# Project Status Report: [Project Name]
+**Period:** [Date range] | **Author:** [PM] | **Next report:** [Date]
+
+---
+
+### Overall Status
+
+| Dimension | Status | Last period | Trend |
+|---|---|---|---|
+| Overall | Red / Amber / Green | [Last] | Improving / Stable / Declining |
+| Schedule | | | |
+| Budget | | | |
+| Scope | | | |
+| Risks | | | |
+
+RAG definitions:
+- Green: On track. No significant issues.
+- Amber: At risk. Issues identified but mitigations in place.
+- Red: Off track. Escalation or decisions required to recover.
+
+---
+
+### Executive Summary
+[3-5 sentences. Headline story. If it is Red, say so immediately and why. Never bury bad news after good news.]
+
+---
+
+### Milestone Progress
+
+| Milestone | Due date | Status | Comment |
+|---|---|---|---|
+| [Milestone] | [Date] | Complete / At risk / Delayed / On track | [One line] |
+
+**Completed this period:** [What was delivered]
+**Due next period:** [What is expected]
+
+---
+
+### Issues and Blockers
+
+**[Issue title] — Critical / High / Low**
+- **Description:** [What the issue is]
+- **Impact:** [What happens if unresolved]
+- **Owner:** [Who is resolving]
+- **Action:** [What is being done]
+- **Resolution date:** [When it will be closed]
+
+---
+
+### Risks
+
+| Risk | Likelihood | Impact | Mitigation | Owner |
+|---|---|---|---|---|
+| [Risk] | H/M/L | H/M/L | [Action] | [Name] |
+
+---
+
+### Decisions Required
+
+| Decision | Background | Options | Recommendation | Needed by |
+|---|---|---|---|---|
+| [Decision] | [Context] | [Options] | [Recommendation] | [Date] |
+
+---
+
+### Budget Summary
+
+| | Budget | Actual to date | Forecast | Variance |
+|---|---|---|---|---|
+| Total | £ | £ | £ | £ F/A |
+
+---
+
+### Next Period Plan
+[3-5 specific bullet points — what will happen next period]
+
+## Writing Rules
+- Never soften a Red status
+- Milestones are binary: complete or not complete
+- Decisions must be genuinely actionable
+- Keep to one page where possible
+
+## Quality Checks
+
+- [ ] Red status is stated immediately (not buried after positives)
+- [ ] Every issue has a named owner and a resolution date
+- [ ] Decisions required are genuinely actionable by the audience
+- [ ] Milestones are binary (complete or not complete — no "85% done")
+- [ ] Executive summary can stand alone for a stakeholder who reads nothing else
+
+## Anti-Patterns
+
+- [ ] Do not rate project health as Green while listing unresolved critical blockers
+- [ ] Do not report milestone progress as a percentage — milestones are binary: complete or not complete
+- [ ] Do not bury risks at the bottom — if something is high risk, it belongs in the executive summary
+- [ ] Do not leave decisions required without specifying who must decide and by when
+- [ ] Do not write an executive summary that requires reading the full report to understand — it must stand alone
+
+## Example Trigger Phrases
+- "Write a project status report for [project]"
+- "Generate a RAG status update for [project]"
+- "Write the steering committee report for [project]"