@groupby/ai-dev 0.5.10 → 0.5.11

package/teams/fhr-neowise/skills/code-review/review-template.md

@@ -0,0 +1,90 @@
+# Review: <title>
+
+## Metadata
+- Date: <yyyy-mm-dd>
+- Reviewer: <name-or-agent>
+- Decision: <APPROVE|REQUEST_CHANGES|COMMENT>
+- Branch/PR: <branch-or-pr>
+- Base ref: <base-ref>
+- Head ref: <head-ref>
+- Spec: <path>
+- Plan: <path-or-none>
+
+## Scope
+
+### Changed Files
+- <path>
+- <path>
+
+### Excluded Files (if any)
+- <path>: <reason>
+
+## Requirement Checklist
+
+| ID | Type | Requirement | Status (PASS/PARTIAL/FAIL/N/A) | Evidence |
+|---|---|---|---|---|
+| S-1 | Spec | <requirement text> | <status> | <file refs / notes> |
+| A-1 | Acceptance | <criterion text> | <status> | <file refs / notes> |
+| P-1 | Plan | <step text> | <status> | <file refs / notes> |
+
+## Findings
+
+### Blocking and Major Findings
+
+#### [F-001] <short title>
+- Severity: <BLOCKER|MAJOR>
+- Type: <SPEC_GAP|PLAN_DEVIATION|BUG|SECURITY|TEST_GAP|DESIGN|OTHER>
+- Affected files:
+  - <path:line>
+- Evidence:
+  - <what was observed, include line-level refs like module/src/file.ext:123>
+- Requested change:
+  - <exact change needed>
+- Acceptance check:
+  - <objective verification condition>
+- Related requirements:
+  - <S-# / A-# / P-#>
+
+### Minor Findings
+
+#### [F-101] <short title>
+- Severity: <MINOR>
+- Affected files:
+  - <path:line>
+- Evidence:
+  - <what was observed>
+- Requested change:
+  - <exact change needed>
+- Acceptance check:
+  - <objective verification condition>
+
+### Nits
+
+#### [F-201] <short title>
+- Severity: <NIT>
+- Affected files:
+  - <path:line>
+- Evidence:
+  - <what was observed>
+- Requested change:
+  - <exact change needed>
+- Acceptance check:
+  - <objective verification condition>
+
+## Requested Changes (Must Fix Before Approval, All Severities)
+1. <required change 1>
+2. <required change 2>
+
+## Risks and Follow-ups
+- Immediate risks:
+  - <risk>
+- Deferred follow-ups:
+  - <optional, non-blocking>
+
+## Summary
+- Decision: <APPROVE|REQUEST_CHANGES|COMMENT>
+- Blockers: <count>
+- Majors: <count>
+- Minors: <count>
+- Nits: <count>
+- Blocking policy: any finding at any severity requires REQUEST_CHANGES

package/teams/fhr-neowise/skills/mermaid-diagram/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: mermaid-diagram
+description: Generate Mermaid diagrams from user requirements. Supports flowcharts, sequence diagrams, class diagrams, ER diagrams, Gantt charts, and 18 more diagram types.
+allowed-tools: Read Write Edit
+metadata:
+  argument-hint: "[diagram description or requirements]"
+---
+
+# Mermaid Diagram Generator
+
+Generate high-quality Mermaid diagram code based on user requirements.
+
+## Workflow
+
+1. **Understand Requirements**: Analyze user description to determine the most suitable diagram type
+2. **Read Documentation**: Read the corresponding syntax reference for the diagram type
+3. **Generate Code**: Generate Mermaid code following the specification
+4. **Apply Styling**: Apply appropriate themes and style configurations
+
+## Diagram Type Reference
+
+Select the appropriate diagram type and read the corresponding documentation:
+
+| Type                         | Documentation                                                           | Use Cases                                  |
+| ---------------------------- | ----------------------------------------------------------------------- | ------------------------------------------ |
+| Flowchart                    | [flowchart.md](references/flowchart.md)                                 | Processes, decisions, steps                |
+| Sequence Diagram             | [sequenceDiagram.md](references/sequenceDiagram.md)                     | Interactions, messaging, API calls         |
+| Class Diagram                | [classDiagram.md](references/classDiagram.md)                           | Class structure, inheritance, associations |
+| State Diagram                | [stateDiagram.md](references/stateDiagram.md)                           | State machines, state transitions          |
+| ER Diagram                   | [entityRelationshipDiagram.md](references/entityRelationshipDiagram.md) | Database design, entity relationships      |
+| Gantt Chart                  | [gantt.md](references/gantt.md)                                         | Project planning, timelines                |
+| Pie Chart                    | [pie.md](references/pie.md)                                             | Proportions, distributions                 |
+| Mindmap                      | [mindmap.md](references/mindmap.md)                                     | Hierarchical structures, knowledge graphs  |
+| Timeline                     | [timeline.md](references/timeline.md)                                   | Historical events, milestones              |
+| Git Graph                    | [gitgraph.md](references/gitgraph.md)                                   | Branches, merges, versions                 |
+| Quadrant Chart               | [quadrantChart.md](references/quadrantChart.md)                         | Four-quadrant analysis                     |
+| Requirement Diagram          | [requirementDiagram.md](references/requirementDiagram.md)               | Requirements traceability                  |
+| C4 Diagram                   | [c4.md](references/c4.md)                                               | System architecture (C4 model)             |
+| Sankey Diagram               | [sankey.md](references/sankey.md)                                       | Flow, conversions                          |
+| XY Chart                     | [xyChart.md](references/xyChart.md)                                     | Line charts, bar charts                    |
+| Block Diagram                | [block.md](references/block.md)                                         | System components, modules                 |
+| Packet Diagram               | [packet.md](references/packet.md)                                       | Network protocols, data structures         |
+| Kanban                       | [kanban.md](references/kanban.md)                                       | Task management, workflows                 |
+| Architecture Diagram         | [architecture.md](references/architecture.md)                           | System architecture                        |
+| Radar Chart                  | [radar.md](references/radar.md)                                         | Multi-dimensional comparison               |
+| Treemap                      | [treemap.md](references/treemap.md)                                     | Hierarchical data visualization            |
+| User Journey                 | [userJourney.md](references/userJourney.md)                             | User experience flows                      |
+| ZenUML                       | [zenuml.md](references/zenuml.md)                                       | Sequence diagrams (code style)             |
+| Cynefin                      | [cynefin.md](references/cynefin.md)                                     | Auto-synced from upstream                  |
+| Eventmodeling                | [eventmodeling.md](references/eventmodeling.md)                         | Auto-synced from upstream                  |
+| Ishikawa diagram (v11.12.3+) | [ishikawa.md](references/ishikawa.md)                                   | Auto-synced from upstream                  |
+| Railroad                     | [railroad.md](references/railroad.md)                                   | Auto-synced from upstream                  |
+| TreeView Diagram (v11.14.0+) | [treeView.md](references/treeView.md)                                   | Auto-synced from upstream                  |
+| Venn diagrams (v11.12.3+)    | [venn.md](references/venn.md)                                           | Auto-synced from upstream                  |
+| Wardley Maps (v11.14.0+)     | [wardley.md](references/wardley.md)                                     | Auto-synced from upstream                  |
+
+## Configuration & Themes
+
+- [Theming](references/config-theming.md) - Custom colors and styles
+- [Directives](references/config-directives.md) - Diagram-level configuration
+- [Layouts](references/config-layouts.md) - Layout direction and spacing
+- [Configuration](references/config-configuration.md) - Global settings
+- [Math](references/config-math.md) - LaTeX math support
+
+## Output Specification
+
+Generated Mermaid code should:
+
+1. Be wrapped in ```mermaid code blocks
+2. Have correct syntax that renders directly
+3. Have clear structure with proper line breaks and indentation
+4. Use semantic node naming
+5. Include styling when needed to improve visual appearance
+
+## Example Output
+
+```mermaid
+flowchart TD
+    A[Start] --> B{Condition}
+    B -->|Yes| C[Execute]
+    B -->|No| D[End]
+    C --> D
+```
+
+> [!NOTE]
+> To update the mermaid reference documentation, run the following command in the Mermaid skill directory (`.agents/skills/mermaid-expert/`):
+
+```shell
+python3 scripts/sync_docs.py
+```
+
+---
+
+User requirements: $ARGUMENTS

package/teams/fhr-neowise/skills/mermaid-diagram/references/BEST_PRACTICES.md

@@ -0,0 +1,96 @@
+## Best Practices
+
+### Diagram Design Principles
+
+**Keep diagrams simple:**
+
+- Limit to 15-20 nodes per diagram for readability
+- Use clear, concise labels
+- Group related elements together
+- Use consistent styling
+
+**Effective flowcharts:**
+
+- Follow top-to-bottom or left-to-right flow
+- Use decision points sparingly
+- Color-code different types of actions
+- Add meaningful annotations
+
+**Sequence diagram tips:**
+
+- Show clear message flow
+- Use appropriate message types (sync, async, reply)
+- Group related interactions
+- Highlight important state changes
+
+### Performance Optimization
+
+**For web applications:**
+
+```javascript
+// Initialize Mermaid once
+mermaid.initialize({
+  startOnLoad: false,
+  theme: "default",
+  themeVariables: {
+    primaryColor: "#0066cc",
+    primaryTextColor: "#333",
+  },
+});
+
+// Render diagrams on demand
+const renderDiagram = async (element, definition) => {
+  const { svg } = await mermaid.render("mermaid-diagram", definition);
+  element.innerHTML = svg;
+};
+```
+
+### Accessibility Considerations
+
+**Accessible Mermaid diagrams:**
+
+- Provide alt text descriptions
+- Use high-contrast colors
+- Ensure keyboard navigation
+- Include ARIA labels
+
+```html
+<div class="mermaid" aria-label="User authentication flowchart" role="img">
+  flowchart TD A[Login] --> B{Valid?} B -->|Yes| C[Dashboard] B -->|No| D[Error]
+</div>
+```
+
+## Advanced Features
+
+### Custom Themes
+
+**Define custom theme variables:**
+
+```javascript
+mermaid.initialize({
+  theme: "base",
+  themeVariables: {
+    primaryColor: "#ffcc00",
+    primaryTextColor: "#333333",
+    primaryBorderColor: "#333333",
+    lineColor: "#333333",
+    secondaryColor: "#fff",
+    tertiaryColor: "#fff",
+  },
+});
+```
+
+### Interactive Features
+
+**Click handlers:**
+
+```javascript
+// Add click actions to nodes
+const definition = `
+flowchart LR
+    A[Click Me] --> B{Action}
+
+    click A "https://example.com"
+    click B "alert('Decision point')"
+`;
+```