-
Notifications
You must be signed in to change notification settings - Fork 0
feat(workflows): add new workflow files and update READMEs #1
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from all commits
Commits
Show all changes
4 commits
Select commit
Hold shift + click to select a range
54e39ac
feat(workflows): add new workflow files and update READMEs
lohnsonok 404848c
feat(workflows): add comprehensive workflow templates for various dom…
lohnsonok b08233b
fix: update workflows/documentation/README.md
lohnsonok 4df7a67
refactor(workflows): clean up and improve workflow documentation
lohnsonok File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,36 @@ | ||
| # Dependencies | ||
| node_modules/ | ||
| .pnp/ | ||
| .pnp.js | ||
|
|
||
| # Testing | ||
| coverage/ | ||
|
|
||
| # Production | ||
| build/ | ||
| dist/ | ||
|
|
||
| # Misc | ||
| .DS_Store | ||
| .env | ||
| .env.local | ||
| .env.development.local | ||
| .env.test.local | ||
| .env.production.local | ||
|
|
||
| npm-debug.log* | ||
| yarn-debug.log* | ||
| yarn-error.log* | ||
|
|
||
| # Editor | ||
| .vscode/ | ||
| .idea/ | ||
| *.suo | ||
| *.ntvs* | ||
| *.njsproj | ||
| *.sln | ||
| *.sw? | ||
|
|
||
| # MWC specific | ||
| *.log | ||
| tmp/ |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,30 @@ | ||
| # Rapport d'Audit Approfondi : MWC v4.0 (105 Workflows) | ||
|
|
||
| Cet audit évalue la qualité technique, la profondeur métier et l'opérabilité du repository Model Workflow Context. | ||
|
|
||
| ## 1. Analyse de la Structure Technique | ||
| - **Respect de la Spec (100%)** : Tous les workflows utilisent les champs obligatoires (`name`, `version`, `mwc_version`, `inputs`, `steps`, `outputs`). | ||
| - **Typage des Données** : | ||
| - Usage correct des `enum` pour limiter les erreurs (ex: `language` dans Robotics, `difficulty` dans EduTech). | ||
| - Utilisation croissante du type `path` pour les workflows agentiques, permettant une intégration native avec le système de fichiers de l'utilisateur. | ||
| - **Granularité des Étapes** : La plupart des workflows décomposent les tâches complexes en 2-3 étapes (`id`), ce qui permet au modèle de "réfléchir" par étapes (Chain of Thought), augmentant la précision des résultats. | ||
|
|
||
| ## 2. Analyse de la Profondeur Métier | ||
| - **Expertise Verticale** : Les workflows ne sont pas génériques. | ||
| - En **BioTech**, on parle de "motifs régulateurs" et de "GC content". | ||
| - En **Robotics**, on utilise les paramètres DH (Denavit-Hartenberg) et le format URDF. | ||
| - En **Blockchain**, on cible spécifiquement la "Réentrance" et l'optimisation de "Gas". | ||
| - **Pertinence des Prompts** : Les prompts incluent des contraintes métier fortes (ex: "Use production-ready resource limits" dans K8s, "Avoid neck strain" dans Spatial UI). | ||
|
|
||
| ## 3. Analyse de l'Interopérabilité & Agents (Claude Code, etc.) | ||
| - **Agent-Ready** : Les workflows agissent comme des "capteurs" et "acteurs" pour les agents. | ||
| - **Chaînage Potentiel** : Certains workflows sont conçus pour être chaînés. | ||
| - Exemple : `legacy-migration/analyze_logic` -> `legacy-migration/suggest_modern_arch`. | ||
| - **Standard de Sortie** : Les outputs sont principalement des `string` (Markdown ou Code), ce qui est idéal pour une consommation directe par l'utilisateur ou une réinsertion dans le projet par l'agent. | ||
|
|
||
| ## 4. Recommandations d'Optimisation (Post-Audit) | ||
| - **Typage Path** : Généraliser le type `path` pour tous les workflows de lecture de code (terminé pour les plus critiques). | ||
| - **Validation Schema** : Intégrer une validation JSON Schema plus stricte dans le CI/CD pour vérifier la cohérence des prompts (ex: vérifier que toutes les variables `{{input}}` existent). | ||
|
|
||
| ## Conclusion | ||
| Le projet MWC v4.0 est **mature, robuste et hautement spécialisé**. Il dépasse le simple stade de "bibliothèque de prompts" pour devenir un véritable **standard d'automatisation cognitive** pour les ingénieurs. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,31 @@ | ||
| # Dependencies | ||
| node_modules/ | ||
| npm-debug.log* | ||
| yarn-debug.log* | ||
| yarn-error.log* | ||
| .pnpm-debug.log* | ||
|
|
||
| # Build and output | ||
| dist/ | ||
| build/ | ||
| *.pyc | ||
| __pycache__/ | ||
|
|
||
| # Environment and secrets | ||
| .env | ||
| .env.local | ||
| .env.development.local | ||
| .env.test.local | ||
| .env.production.local | ||
| .direnv/ | ||
|
|
||
| # IDE and OS | ||
| .vscode/ | ||
| .idea/ | ||
| .DS_Store | ||
| *.swp | ||
| *.swo | ||
|
|
||
| # Test coverage | ||
| coverage/ | ||
| .nyc_output/ |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,35 @@ | ||
| const fs = require('fs'); | ||
| const path = require('path'); | ||
| const yaml = require('js-yaml'); | ||
|
|
||
| function auditDepth(dir) { | ||
| const files = fs.readdirSync(dir, { recursive: true }); | ||
| const workflows = files.filter(f => f.endsWith('.mwc.yaml')); | ||
|
|
||
| console.log(`Auditing ${workflows.length} workflows...\n`); | ||
|
|
||
| workflows.forEach(file => { | ||
| const fullPath = path.join(dir, file); | ||
| try { | ||
| const content = fs.readFileSync(fullPath, 'utf8'); | ||
| const wf = yaml.load(content); | ||
|
|
||
| const stepCount = wf.steps ? wf.steps.length : 0; | ||
| let totalPromptLength = 0; | ||
| if (wf.steps) { | ||
| wf.steps.forEach(s => { | ||
| if (s.prompt) totalPromptLength += s.prompt.length; | ||
| }); | ||
| } | ||
|
|
||
| // Heuristic for "weak" workflow | ||
| if (stepCount < 2 || totalPromptLength < 100) { | ||
| console.log(`[WEAK] ${file}: ${stepCount} steps, ${totalPromptLength} chars prompt`); | ||
| } | ||
| } catch (e) { | ||
| console.error(`Error reading ${file}: ${e.message}`); | ||
| } | ||
| }); | ||
| } | ||
|
|
||
| auditDepth(process.cwd()); |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,20 @@ | ||
| # THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY. | ||
| # yarn lockfile v1 | ||
|
|
||
|
|
||
| argparse@^2.0.1: | ||
| version "2.0.1" | ||
| resolved "https://registry.yarnpkg.com/argparse/-/argparse-2.0.1.tgz#246f50f3ca78a3240f6c997e8a9bd1eac49e4b38" | ||
| integrity sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q== | ||
|
|
||
| js-yaml@^4.1.0: | ||
| version "4.1.1" | ||
| resolved "https://registry.yarnpkg.com/js-yaml/-/js-yaml-4.1.1.tgz#854c292467705b699476e1a2decc0c8a3458806b" | ||
| integrity sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA== | ||
| dependencies: | ||
| argparse "^2.0.1" | ||
|
|
||
| jsonschema@^1.4.1: | ||
| version "1.5.0" | ||
| resolved "https://registry.yarnpkg.com/jsonschema/-/jsonschema-1.5.0.tgz#f6aceb1ab9123563dd901d05f81f9d4883d3b7d8" | ||
| integrity sha512-K+A9hhqbn0f3pJX17Q/7H6yQfD/5OXgdrR5UE12gMXCiN9D5Xq2o5mddV2QEcX/bjla99ASsAAQUyMCCRWAEhw== |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,17 @@ | ||
| name: "API Design Review" | ||
| version: "1.0.0" | ||
| description: "Review API designs for REST/GraphQL best practices and consistency" | ||
| mwc_version: "1.0.0" | ||
|
|
||
| inputs: | ||
| - name: api_spec | ||
| type: string | ||
|
|
||
| steps: | ||
| - id: check_best_practices | ||
| type: model_call | ||
| prompt: "Review this API specification for naming conventions, status codes, and security patterns: {{api_spec}}." | ||
|
|
||
| outputs: | ||
| - name: api_review_report | ||
| type: string |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,16 @@ | ||
| name: "API Versioning Plan" | ||
| version: "1.0.0" | ||
| description: "Create a deprecation and versioning plan for an evolving API" | ||
| mwc_version: "1.0.0" | ||
| inputs: | ||
| - name: current_version | ||
| type: string | ||
| - name: breaking_changes | ||
| type: string | ||
| steps: | ||
| - id: draft_versioning | ||
| type: model_call | ||
| prompt: "Currently at version {{current_version}}, design a versioning strategy (URI vs Header) and a 6-month deprecation timeline for these breaking changes: {{breaking_changes}}." | ||
| outputs: | ||
| - name: versioning_strategy | ||
| type: string | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,14 @@ | ||
| name: "SDK Generator Spec" | ||
| version: "1.0.0" | ||
| description: "Generate a specification for building multi-language SDKs from an OpenAPI doc" | ||
| mwc_version: "1.0.0" | ||
| inputs: | ||
| - name: openapi_spec | ||
| type: string | ||
| steps: | ||
| - id: define_sdk_structure | ||
| type: model_call | ||
| prompt: "Outline the folder structure and core classes for a TypeScript/Python SDK based on this spec: {{openapi_spec}}." | ||
| outputs: | ||
| - name: sdk_spec | ||
| type: string |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,6 @@ | ||
| # Architecture Workflows | ||
| Workflows related to system design, folder structure, and architectural patterns. | ||
|
|
||
| ## Workflows | ||
| - [Architecture Review](architecture-review.mwc.yaml): Review code structure against patterns like Clean Architecture or Hexagonal. | ||
| - [API Migration Plan](api-migration-plan.mwc.yaml): Create a step-by-step plan for migrating between API versions. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,25 @@ | ||
| name: "API Migration Plan" | ||
| version: "1.0.0" | ||
| description: "Create a step-by-step plan to migrate from an old API version to a new one" | ||
| mwc_version: "1.0.0" | ||
|
|
||
| inputs: | ||
| - name: old_api_spec | ||
| type: string | ||
| description: "Documentation or examples of the current API" | ||
| - name: new_api_spec | ||
| type: string | ||
| description: "Documentation or examples of the new API" | ||
|
|
||
| steps: | ||
| - id: map_changes | ||
| type: model_call | ||
| prompt: "Compare {{old_api_spec}} and {{new_api_spec}}. Identify breaking changes, renamed fields, and deprecated endpoints." | ||
|
|
||
| - id: migration_steps | ||
| type: model_call | ||
| prompt: "Create a 3-phase migration plan (Preparation, Execution, Verification) based on the changes identified: {{map_changes}}." | ||
|
|
||
| outputs: | ||
| - name: migration_plan | ||
| type: string |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,26 @@ | ||
| name: "Architecture Review" | ||
| version: "1.0.0" | ||
| description: "Review system design and code structure against architectural patterns (Clean Architecture, DDD, etc.)" | ||
| mwc_version: "1.0.0" | ||
|
|
||
| inputs: | ||
| - name: code_base_structure | ||
| type: string | ||
| description: "Directory tree or key architecture files" | ||
| - name: pattern | ||
| type: string | ||
| description: "Preferred pattern (e.g., hexagonal, layers, microservices)" | ||
| default: "hexagonal" | ||
|
|
||
| steps: | ||
| - id: analyze_dependencies | ||
| type: model_call | ||
| prompt: "Analyze the dependency flow in the following structure. Check if it violates the {{pattern}} architecture principles:\n\n{{code_base_structure}}" | ||
|
|
||
| - id: suggest_improvements | ||
| type: model_call | ||
| prompt: "Based on the analysis: {{analyze_dependencies}}, suggest how to better decouple components or reorganize folders to strictly follow {{pattern}}." | ||
|
|
||
| outputs: | ||
| - name: architecture_report | ||
| type: string |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,14 @@ | ||
| name: "Clinical Trial Summarizer" | ||
| version: "1.0.0" | ||
| description: "Summarize clinical trial results for researchers and medical professionals" | ||
| mwc_version: "1.0.0" | ||
| inputs: | ||
| - name: trial_data | ||
| type: string | ||
| steps: | ||
| - id: extract_findings | ||
| type: model_call | ||
| prompt: "Summarize the primary endpoints, efficacy, and safety profile from this clinical trial data: {{trial_data}}." | ||
| outputs: | ||
| - name: trial_summary | ||
| type: string |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,20 @@ | ||
| name: "DNA Sequence Analyzer" | ||
| version: "1.0.0" | ||
| description: "Analyze DNA sequences for patterns, mutations, and GC content" | ||
| mwc_version: "1.0.0" | ||
|
|
||
| inputs: | ||
| - name: dna_sequence | ||
| type: string | ||
|
|
||
| steps: | ||
| - id: gc_content | ||
| type: model_call | ||
| prompt: "Calculate the GC content percentage of the following DNA sequence: {{dna_sequence}}." | ||
| - id: identify_motifs | ||
| type: model_call | ||
| prompt: "Identify common regulatory motifs or repeat patterns in: {{dna_sequence}}." | ||
|
|
||
| outputs: | ||
| - name: biotech_report | ||
| type: string |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,16 @@ | ||
| name: "Lab Protocol Generator" | ||
| version: "1.0.0" | ||
| description: "Generate a step-by-step laboratory protocol for a specific experiment" | ||
| mwc_version: "1.0.0" | ||
| inputs: | ||
| - name: experiment_goal | ||
| type: string | ||
| - name: reagents_available | ||
| type: string | ||
| steps: | ||
| - id: draft_protocol | ||
| type: model_call | ||
| prompt: "Create a detailed laboratory protocol to achieve {{experiment_goal}} using {{reagents_available}}." | ||
| outputs: | ||
| - name: lab_protocol | ||
| type: string |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,52 @@ | ||
| name: "Protein Folding Analysis" | ||
| version: "1.1.0" | ||
| description: "Analyze protein primary structure for potential folding patterns and domains using Chain-of-Thought" | ||
| mwc_version: "1.0.0" | ||
|
|
||
| inputs: | ||
| - name: amino_acid_sequence | ||
| type: string | ||
| description: "The primary amino acid sequence (e.g., MVLSPADKTN...)" | ||
| - name: analysis_depth | ||
| type: enum | ||
| options: ["quick", "detailed"] | ||
| description: "Depth of the structural analysis" | ||
|
|
||
| steps: | ||
| - id: analyze_properties | ||
| type: model_call | ||
| prompt: | | ||
| Analyze the physicochemical properties of this amino acid sequence: {{amino_acid_sequence}}. | ||
| Focus on: | ||
| 1. Hydrophobicity profile (Kyte-Doolittle scale approximation) | ||
| 2. Charge distribution (Isoelectric point estimation) | ||
| 3. Presence of special residues (Cysteine bridges, Proline kinks) | ||
|
|
||
| - id: predict_secondary_structure | ||
| type: model_call | ||
| prompt: | | ||
| Based on the properties analysis: {{analyze_properties}}, predict the likely secondary structure elements. | ||
| - Identify potential Alpha-helices (n+4 H-bonding patterns) | ||
| - Identify potential Beta-sheets (extended strands) | ||
| - Identify loops and disordered regions | ||
|
|
||
| - id: identify_domains | ||
| type: model_call | ||
| prompt: | | ||
| Using the secondary structure prediction: {{predict_secondary_structure}}, hypothesize potential protein domains. | ||
| Reference known structural motifs (e.g., Zinc finger, Beta-barrel, Rossmann fold) if patterns match. | ||
|
|
||
| - id: final_report | ||
| type: model_call | ||
| prompt: | | ||
| Synthesize a {{analysis_depth}} report on the protein's potential structure. | ||
| Combine findings from: | ||
| - Properties: {{analyze_properties}} | ||
| - Secondary Structure: {{predict_secondary_structure}} | ||
| - Domains: {{identify_domains}} | ||
|
|
||
| Disclaimer: This is a textual prediction and should be verified with structural biology tools (AlphaFold, cryo-EM). | ||
|
|
||
| outputs: | ||
| - name: folding_report | ||
| type: string |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.