{"id":"fef03ed9-990d-4ba0-b0a0-2842db95d968","shortId":"5BunNq","kind":"skill","title":"Project Workflow Analysis Blueprint Generator","tagline":"Awesome Copilot skill by Github","description":"# Project Workflow Documentation Generator\n\n## Configuration Variables\n\n```\n${PROJECT_TYPE=\"Auto-detect|.NET|Java|Spring|Node.js|Python|React|Angular|Microservices|Other\"}\n<!-- Primary technology stack -->\n\n${ENTRY_POINT=\"API|GraphQL|Frontend|CLI|Message Consumer|Scheduled Job|Custom\"}\n<!-- Starting point for the flow -->\n\n${PERSISTENCE_TYPE=\"Auto-detect|SQL Database|NoSQL Database|File System|External API|Message Queue|Cache|None\"}\n<!-- Data storage type -->\n\n${ARCHITECTURE_PATTERN=\"Auto-detect|Layered|Clean|CQRS|Microservices|MVC|MVVM|Serverless|Event-Driven|Other\"}\n<!-- Primary architecture pattern -->\n\n${WORKFLOW_COUNT=1-5}\n<!-- Number of workflows to document -->\n\n${DETAIL_LEVEL=\"Standard|Implementation-Ready\"}\n<!-- Level of implementation detail to include -->\n\n${INCLUDE_SEQUENCE_DIAGRAM=true|false}\n<!-- Generate sequence diagram -->\n\n${INCLUDE_TEST_PATTERNS=true|false}\n<!-- Include testing approach -->\n```\n\n## Generated Prompt\n\n```\n\"Analyze the codebase and document ${WORKFLOW_COUNT} representative end-to-end workflows \nthat can serve as implementation templates for similar features. Use the following approach:\n```\n\n### Initial Detection Phase\n\n```\n${PROJECT_TYPE == \"Auto-detect\" ? \n  \"Begin by examining the codebase structure to identify technologies:\n   - Check for .NET solutions/projects, Spring configurations, Node.js/Express files, etc.\n   - Identify the primary programming language(s) and frameworks in use\n   - Determine the architectural patterns based on folder structure and key components\" \n  : \"Focus on ${PROJECT_TYPE} patterns and conventions\"}\n```\n\n```\n${ENTRY_POINT == \"Auto-detect\" ? \n  \"Identify typical entry points by looking for:\n   - API controllers or route definitions\n   - GraphQL resolvers\n   - UI components that initiate network requests\n   - Message handlers or event subscribers\n   - Scheduled job definitions\" \n  : \"Focus on ${ENTRY_POINT} entry points\"}\n```\n\n```\n${PERSISTENCE_TYPE == \"Auto-detect\" ? \n  \"Determine persistence mechanisms by examining:\n   - Database context/connection configurations\n   - Repository implementations\n   - ORM mappings\n   - External API clients\n   - File system interactions\" \n  : \"Focus on ${PERSISTENCE_TYPE} interactions\"}\n```\n\n### Workflow Documentation Instructions\n\nFor each of the `${WORKFLOW_COUNT}` most representative workflow(s) in the system:\n\n#### 1. Workflow Overview\n   - Provide a name and brief description of the workflow\n   - Explain the business purpose it serves\n   - Identify the triggering action or event\n   - List all files/classes involved in the complete workflow\n\n#### 2. Entry Point Implementation\n\n**API Entry Points:**\n```\n${ENTRY_POINT == \"API\" || ENTRY_POINT == \"Auto-detect\" ? \n  \"- Document the API controller class and method that receives the request\n   - Show the complete method signature including attributes/annotations\n   - Include the full request DTO/model class definition\n   - Document validation attributes and custom validators\n   - Show authentication/authorization attributes and checks\" : \"\"}\n```\n\n**GraphQL Entry Points:**\n```\n${ENTRY_POINT == \"GraphQL\" || ENTRY_POINT == \"Auto-detect\" ? \n  \"- Document the GraphQL resolver class and method\n   - Show the complete schema definition for the query/mutation\n   - Include input type definitions\n   - Show resolver method implementation with parameter handling\" : \"\"}\n```\n\n**Frontend Entry Points:**\n```\n${ENTRY_POINT == \"Frontend\" || ENTRY_POINT == \"Auto-detect\" ? \n  \"- Document the component that initiates the API call\n   - Show the event handler that triggers the request\n   - Include the API client service method\n   - Show state management code related to the request\" : \"\"}\n```\n\n**Message Consumer Entry Points:**\n```\n${ENTRY_POINT == \"Message Consumer\" || ENTRY_POINT == \"Auto-detect\" ? \n  \"- Document the message handler class and method\n   - Show message subscription configuration\n   - Include the complete message model definition\n   - Show deserialization and validation logic\" : \"\"}\n```\n\n#### 3. Service Layer Implementation\n   - Document each service class involved with their dependencies\n   - Show the complete method signatures with parameters and return types\n   - Include actual method implementations with key business logic\n   - Document interface definitions where applicable\n   - Show dependency injection registration patterns\n\n**CQRS Patterns:**\n```\n${ARCHITECTURE_PATTERN == \"CQRS\" || ARCHITECTURE_PATTERN == \"Auto-detect\" ? \n  \"- Include complete command/query handler implementations\" : \"\"}\n```\n\n**Clean Architecture Patterns:**\n```\n${ARCHITECTURE_PATTERN == \"Clean\" || ARCHITECTURE_PATTERN == \"Auto-detect\" ? \n  \"- Show use case/interactor implementations\" : \"\"}\n```\n\n#### 4. Data Mapping Patterns\n   - Document DTO to domain model mapping code\n   - Show object mapper configurations or manual mapping methods\n   - Include validation logic during mapping\n   - Document any domain events created during mapping\n\n#### 5. Data Access Implementation\n   - Document repository interfaces and their implementations\n   - Show complete method signatures with parameters and return types\n   - Include actual query implementations\n   - Document entity/model class definitions with all properties\n   - Show transaction handling patterns\n\n**SQL Database Patterns:**\n```\n${PERSISTENCE_TYPE == \"SQL Database\" || PERSISTENCE_TYPE == \"Auto-detect\" ? \n  \"- Include ORM configurations, annotations, or Fluent API usage\n   - Show actual SQL queries or ORM statements\" : \"\"}\n```\n\n**NoSQL Database Patterns:**\n```\n${PERSISTENCE_TYPE == \"NoSQL Database\" || PERSISTENCE_TYPE == \"Auto-detect\" ? \n  \"- Show document structure definitions\n   - Include document query/update operations\" : \"\"}\n```\n\n#### 6. Response Construction\n   - Document response DTO/model class definitions\n   - Show mapping from domain/entity models to response models\n   - Include status code selection logic\n   - Document error response structure and generation\n\n#### 7. Error Handling Patterns\n   - Document exception types used in the workflow\n   - Show try/catch patterns at each layer\n   - Include global exception handler configurations\n   - Document error logging implementations\n   - Show retry policies or circuit breaker patterns\n   - Include compensating actions for failure scenarios\n\n#### 8. Asynchronous Processing Patterns\n   - Document background job scheduling code\n   - Show event publication implementations\n   - Include message queue sending patterns\n   - Document callback or webhook implementations\n   - Show how async operations are tracked and monitored\n\n**Testing Approach (Optional):**\n```\n${INCLUDE_TEST_PATTERNS ? \n  \"9. **Testing Approach**\n     - Document unit test implementations for each layer\n     - Show mocking patterns and test fixture setup\n     - Include integration test implementations\n     - Document test data generation approaches\n     - Show API/controller test implementations\" : \"\"}\n```\n\n**Sequence Diagram (Optional):**\n```\n${INCLUDE_SEQUENCE_DIAGRAM ? \n  \"10. **Sequence Diagram**\n      - Generate a detailed sequence diagram showing all components\n      - Include method calls with parameter types\n      - Show return values between components\n      - Document conditional flows and error paths\" : \"\"}\n```\n\n#### 11. Naming Conventions\nDocument consistent patterns for:\n- Controller naming (e.g., `EntityNameController`)\n- Service naming (e.g., `EntityNameService`)\n- Repository naming (e.g., `IEntityNameRepository`)\n- DTO naming (e.g., `EntityNameRequest`, `EntityNameResponse`)\n- Method naming patterns for CRUD operations\n- Variable naming conventions\n- File organization patterns\n\n#### 12. Implementation Templates\nProvide reusable code templates for:\n- Creating a new API endpoint following the pattern\n- Implementing a new service method\n- Adding a new repository method\n- Creating new domain model classes\n- Implementing proper error handling\n\n### Technology-Specific Implementation Patterns\n\n**.NET Implementation Patterns (if detected):**\n```\n${PROJECT_TYPE == \".NET\" || PROJECT_TYPE == \"Auto-detect\" ? \n  \"- Complete controller class with attributes, filters, and dependency injection\n   - Service registration in Startup.cs or Program.cs\n   - Entity Framework DbContext configuration\n   - Repository implementation with EF Core or Dapper\n   - AutoMapper profile configurations\n   - Middleware implementations for cross-cutting concerns\n   - Extension method patterns\n   - Options pattern implementation for configuration\n   - Logging implementation with ILogger\n   - Authentication/authorization filter or policy implementations\" : \"\"}\n```\n\n**Spring Implementation Patterns (if detected):**\n```\n${PROJECT_TYPE == \"Java\" || PROJECT_TYPE == \"Spring\" || PROJECT_TYPE == \"Auto-detect\" ? \n  \"- Complete controller class with annotations and dependency injection\n   - Service implementation with transaction boundaries\n   - Repository interface and implementation\n   - JPA entity definitions with relationships\n   - DTO class implementations\n   - Bean configuration and component scanning\n   - Exception handler implementations\n   - Custom validator implementations\" : \"\"}\n```\n\n**React Implementation Patterns (if detected):**\n```\n${PROJECT_TYPE == \"React\" || PROJECT_TYPE == \"Auto-detect\" ? \n  \"- Component structure with props and state\n   - Hook implementation patterns (useState, useEffect, custom hooks)\n   - API service implementation\n   - State management patterns (Context, Redux)\n   - Form handling implementations\n   - Route configuration\" : \"\"}\n```\n\n### Implementation Guidelines\n\nBased on the documented workflows, provide specific guidance for implementing new features:\n\n#### 1. Step-by-Step Implementation Process\n- Where to start when adding a similar feature\n- Order of implementation (e.g., model → repository → service → controller)\n- How to integrate with existing cross-cutting concerns\n\n#### 2. Common Pitfalls to Avoid\n- Identify error-prone areas in the current implementation\n- Note performance considerations\n- List common bugs or issues encountered\n\n#### 3. Extension Mechanisms\n- Document how to plug into existing extension points\n- Show how to add new behavior without modifying existing code\n- Explain configuration-driven feature patterns\n\n**Conclusion:**\nConclude with a summary of the most important patterns that should be followed when \nimplementing new features to maintain consistency with the codebase.\"","tags":["project","workflow","analysis","blueprint","generator","awesome","copilot","github"],"capabilities":["skill","source-github","category-awesome-copilot"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/project-workflow-analysis-blueprint-generator","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"install_from":"skills.sh"}},"qualityScore":"0.300","qualityRationale":"deterministic score 0.30 from registry signals: · indexed on skills.sh · published under github/awesome-copilot","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T14:40:17.279Z","embedding":null,"createdAt":"2026-04-18T20:25:45.022Z","updatedAt":"2026-04-22T14:40:17.279Z","lastSeenAt":"2026-04-22T14:40:17.279Z","tsv":"'-5':78 '/express':148 '1':77,262,1054 '10':779 '11':807 '12':843 '2':294,1086 '3':458,1109 '4':528 '5':559 '6':640 '7':667 '8':706 '9':743 'access':561 'action':283,702 'actual':481,579,614 'ad':864,1065 'add':1123 'analysi':3 'analyz':97 'angular':28 'annot':608,969 'api':33,54,191,236,298,303,311,399,411,611,854,1027 'api/controller':770 'applic':492 'approach':122,738,745,768 'architectur':59,163,500,503,514,516,519 'area':1095 'async':731 'asynchron':707 'attribut':336,342,900 'attributes/annotations':326 'authentication/authorization':341,944 'auto':20,45,62,129,182,221,307,354,391,434,506,522,603,630,894,963,1012 'auto-detect':19,44,61,128,181,220,306,353,390,433,505,521,602,629,893,962,1011 'automapp':922 'avoid':1090 'awesom':6 'background':711 'base':165,1042 'bean':990 'begin':131 'behavior':1125 'blueprint':4 'boundari':977 'breaker':698 'brief':269 'bug':1105 'busi':276,486 'cach':57 'call':400,792 'callback':725 'case/interactor':526 'category-awesome-copilot' 'check':140,344 'circuit':697 'class':313,332,360,440,465,584,646,873,898,967,988 'clean':65,513,518 'cli':36 'client':237,412 'code':418,538,658,714,848,1129 'codebas':99,135,1159 'command/query':510 'common':1087,1104 'compens':701 'complet':292,322,365,449,472,509,570,896,965 'compon':171,199,395,789,800,993,1014 'concern':931,1085 'conclud':1137 'conclus':1136 'condit':802 'configur':15,145,230,446,542,607,688,914,924,939,991,1039,1132 'configuration-driven':1131 'consider':1102 'consist':811,1156 'construct':642 'consum':38,424,430 'context':1033 'context/connection':229 'control':192,312,814,897,966,1076 'convent':178,809,839 'copilot':7 'core':919 'count':76,103,254 'cqrs':66,498,502 'creat':556,851,869 'cross':929,1083 'cross-cut':928,1082 'crud':835 'current':1098 'custom':41,338,998,1025 'cut':930,1084 'dapper':921 'data':529,560,766 'databas':48,50,228,594,599,621,626 'dbcontext':913 'definit':195,211,333,367,374,452,490,585,635,647,984 'depend':469,494,903,971 'descript':270 'deseri':454 'detail':79,784 'detect':21,46,63,124,130,183,222,308,355,392,435,507,523,604,631,887,895,953,964,1005,1013 'determin':161,223 'diagram':87,774,778,781,786 'document':13,101,247,309,334,356,393,436,462,488,532,552,563,582,633,637,643,661,671,689,710,724,746,764,801,810,1045,1112 'domain':535,554,871 'domain/entity':651 'driven':73,1133 'dto':533,826,987 'dto/model':331,645 'e.g':816,820,824,828,1072 'ef':918 'encount':1108 'end':106,108 'end-to-end':105 'endpoint':855 'entiti':911,983 'entity/model':583 'entitynamecontrol':817 'entitynamerequest':829 'entitynamerespons':830 'entitynameservic':821 'entri':31,179,186,214,216,295,299,301,304,346,348,351,383,385,388,425,427,431 'error':662,668,690,805,876,1093 'error-pron':1092 'etc':150 'event':72,207,285,403,555,716 'event-driven':71 'examin':133,227 'except':672,686,995 'exist':1081,1117,1128 'explain':274,1130 'extens':932,1110,1118 'extern':53,235 'failur':704 'fals':89,94 'featur':118,1053,1068,1134,1153 'file':51,149,238,840 'files/classes':288 'filter':901,945 'fixtur':758 'flow':803 'fluent':610 'focus':172,212,241 'folder':167 'follow':121,856,1149 'form':1035 'framework':158,912 'frontend':35,382,387 'full':329 'generat':5,14,95,666,767,782 'github':10 'global':685 'graphql':34,196,345,350,358 'guidanc':1049 'guidelin':1041 'handl':381,591,669,877,1036 'handler':205,404,439,511,687,996 'hook':1020,1026 'identifi':138,151,184,280,1091 'ientitynamerepositori':825 'ilogg':943 'implement':83,114,232,297,378,461,483,512,527,562,568,581,692,718,728,749,763,772,844,859,874,881,884,916,926,937,941,948,950,974,981,989,997,1000,1002,1021,1029,1037,1040,1051,1059,1071,1099,1151 'implementation-readi':82 'import':1144 'includ':85,90,325,327,371,409,447,480,508,547,578,605,636,656,684,700,719,740,760,776,790 'initi':123,201,397 'inject':495,904,972 'input':372 'instruct':248 'integr':761,1079 'interact':240,245 'interfac':489,565,979 'involv':289,466 'issu':1107 'java':23,956 'job':40,210,712 'jpa':982 'key':170,485 'languag':155 'layer':64,460,683,752 'level':80 'list':286,1103 'log':691,940 'logic':457,487,549,660 'look':189 'maintain':1155 'manag':417,1031 'manual':544 'map':234,530,537,545,551,558,649 'mapper':541 'mechan':225,1111 'messag':37,55,204,423,429,438,444,450,720 'method':315,323,362,377,414,442,473,482,546,571,791,831,863,868,933 'microservic':29,67 'middlewar':925 'mock':754 'model':451,536,652,655,872,1073 'modifi':1127 'monitor':736 'mvc':68 'mvvm':69 'name':267,808,815,819,823,827,832,838 'net':22,142,883,890 'network':202 'new':853,861,866,870,1052,1124,1152 'node.js':25,147 'node.js/express':146 'none':58 'nosql':49,620,625 'note':1100 'object':540 'oper':639,732,836 'option':739,775,935 'order':1069 'organ':841 'orm':233,606,618 'overview':264 'paramet':380,476,574,794 'path':806 'pattern':60,92,164,176,497,499,501,504,515,517,520,531,592,595,622,670,680,699,709,723,742,755,812,833,842,858,882,885,934,936,951,1003,1022,1032,1135,1145 'perform':1101 'persist':42,218,224,243,596,600,623,627 'phase':125 'pitfal':1088 'plug':1115 'point':32,180,187,215,217,296,300,302,305,347,349,352,384,386,389,426,428,432,1119 'polici':695,947 'primari':153 'process':708,1060 'profil':923 'program':154 'program.cs':910 'project':1,11,17,126,174,888,891,954,957,960,1006,1009 'prompt':96 'prone':1094 'prop':1017 'proper':875 'properti':588 'provid':265,846,1047 'public':717 'purpos':277 'python':26 'queri':580,616 'query/mutation':370 'query/update':638 'queue':56,721 'react':27,1001,1008 'readi':84 'receiv':317 'redux':1034 'registr':496,906 'relat':419 'relationship':986 'repositori':231,564,822,867,915,978,1074 'repres':104,256 'request':203,319,330,408,422 'resolv':197,359,376 'respons':641,644,654,663 'retri':694 'return':478,576,797 'reusabl':847 'rout':194,1038 'scan':994 'scenario':705 'schedul':39,209,713 'schema':366 'select':659 'send':722 'sequenc':86,773,777,780,785 'serv':112,279 'serverless':70 'servic':413,459,464,818,862,905,973,1028,1075 'setup':759 'show':320,340,363,375,401,415,443,453,470,493,524,539,569,589,613,632,648,678,693,715,729,753,769,787,796,1120 'signatur':324,474,572 'similar':117,1067 'skill':8 'solutions/projects':143 'source-github' 'specif':880,1048 'spring':24,144,949,959 'sql':47,593,598,615 'standard':81 'start':1063 'startup.cs':908 'state':416,1019,1030 'statement':619 'status':657 'step':1056,1058 'step-by-step':1055 'structur':136,168,634,664,1015 'subscrib':208 'subscript':445 'summari':1140 'system':52,239,261 'technolog':139,879 'technology-specif':878 'templat':115,845,849 'test':91,737,741,744,748,757,762,765,771 'track':734 'transact':590,976 'trigger':282,406 'true':88,93 'try/catch':679 'type':18,43,127,175,219,244,373,479,577,597,601,624,628,673,795,889,892,955,958,961,1007,1010 'typic':185 'ui':198 'unit':747 'usag':612 'use':119,160,525,674 'useeffect':1024 'usest':1023 'valid':335,339,456,548,999 'valu':798 'variabl':16,837 'webhook':727 'without':1126 'workflow':2,12,75,102,109,246,253,257,263,273,293,677,1046","prices":[{"id":"4b3288ac-531f-42e0-978d-c959aa03d07a","listingId":"fef03ed9-990d-4ba0-b0a0-2842db95d968","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"github","category":"awesome-copilot","install_from":"skills.sh"},"createdAt":"2026-04-18T20:25:45.022Z"}],"sources":[{"listingId":"fef03ed9-990d-4ba0-b0a0-2842db95d968","source":"github","sourceId":"github/awesome-copilot/project-workflow-analysis-blueprint-generator","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/project-workflow-analysis-blueprint-generator","isPrimary":false,"firstSeenAt":"2026-04-18T21:50:41.220Z","lastSeenAt":"2026-04-22T12:52:20.666Z"},{"listingId":"fef03ed9-990d-4ba0-b0a0-2842db95d968","source":"skills_sh","sourceId":"github/awesome-copilot/project-workflow-analysis-blueprint-generator","sourceUrl":"https://skills.sh/github/awesome-copilot/project-workflow-analysis-blueprint-generator","isPrimary":true,"firstSeenAt":"2026-04-18T20:25:45.022Z","lastSeenAt":"2026-04-22T14:40:17.279Z"}],"details":{"listingId":"fef03ed9-990d-4ba0-b0a0-2842db95d968","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"project-workflow-analysis-blueprint-generator","source":"skills_sh","category":"awesome-copilot","skills_sh_url":"https://skills.sh/github/awesome-copilot/project-workflow-analysis-blueprint-generator"},"updatedAt":"2026-04-22T14:40:17.279Z"}}