feat: add aidlc-workflow-guide skill with aidlc-specialist agent#271
Open
mashharuki wants to merge 3 commits into
Open
feat: add aidlc-workflow-guide skill with aidlc-specialist agent#271mashharuki wants to merge 3 commits into
mashharuki wants to merge 3 commits into
Conversation
mashharuki
requested review from
a team,
Kalindi-Dev,
Copilot,
harmjeff,
leandrodamascena,
raj-jain-aws,
scottschreckengaust and
spraja08
github-actions
Bot
added
the
documentation
Contributor
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
Introduces a new aidlc-workflow-guide skill that serves as a real-time AI-DLC development companion for GitHub Copilot and Claude Code, providing phase-specific guidance through requirements, design, implementation, testing, and refactoring.
Changes:
- Adds the
aidlc-workflow-guideskill withSKILL.md, a sub-agent definition (aidlc-specialist.md), and five phase-specific reference guides. - Updates the README with installation instructions for GitHub Copilot and Claude Code.
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| skills/aidlc-workflow-guide/SKILL.md | Defines top-level skill metadata and phase routing. |
| skills/aidlc-workflow-guide/agents/aidlc-specialist.md | Specifies the AI-DLC sub-agent role, workflow stages, and rules. |
| skills/aidlc-workflow-guide/references/requirements-phase.md | Guide for requirements analysis and user stories. |
| skills/aidlc-workflow-guide/references/design-phase.md | Guide for application design and unit-of-work decomposition. |
| skills/aidlc-workflow-guide/references/implementation-phase.md | Guide for code/IaC generation and Mob Construction. |
| skills/aidlc-workflow-guide/references/testing-phase.md | Guide for test strategy, unit/integration testing. |
| skills/aidlc-workflow-guide/references/refactoring-phase.md | Guide for refactoring priorities and recording technical debt. |
| README.md | Adds setup instructions for the new skill. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| sortKey: { name: 'sk', type: dynamodb.AttributeType.STRING }, | ||
| billingMode: dynamodb.BillingMode.PAY_PER_REQUEST, // Cost optimization | ||
| removalPolicy: cdk.RemovalPolicy.DESTROY, // Development only | ||
| pointInTimeRecovery: true, // Required for production |
Comment on lines
+63
to
+69
| // Good example: type-safe, error handling, single responsibility | ||
| export async function getUserById(userId: string): Promise<User | null> { | ||
| try { | ||
| const result = await dynamoClient.get({ | ||
| TableName: TABLE_NAME, | ||
| Key: { pk: `USER#${userId}` } | ||
| }).promise(); |
| // 4. API Gateway | ||
| const api = new apigateway.RestApi(this, 'Api', { | ||
| defaultCorsPreflightOptions: { | ||
| allowOrigins: apigateway.Cors.ALL_ORIGINS, |
Comment on lines
+787
to
+791
| <my-project>/ | ||
| ├── .github/ | ||
| │ ├── copilot-instructions.md (AI-DLC core workflow rules) | ||
| │ └── skills/ | ||
| │ └── aidlc-workflow-guide/ |
| - **Artifacts**: `aidlc-docs/construction/{unit}/infrastructure-design/infrastructure-design.md` | ||
|
|
||
| ### Code Generation (ALWAYS) | ||
| 2-part structure: |
Author
|
I am currently participating in the AWS Summit Hackathon 2026 in Japan, where I have integrated this sub-agent and additional skills. The generated document repository and actual outputs are available on GitHub via the following link: |
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Summary
Adds the
aidlc-workflow-guideskill andaidlc-specialistsub-agent — a real-time AI-DLC development companion for GitHub Copilot (VS Code) and Claude Code. The skill guides developers through every phase of the AI-DLC workflow (requirements analysis, design, implementation, testing, and refactoring) while generating and reviewing artifacts alongside them.Changes
skills/aidlc-workflow-guide/SKILL.md— Main skill definition. Describes when the skill is invoked, which phases it covers, and how it integrates with theaidlc-specialistagent.skills/aidlc-workflow-guide/agents/aidlc-specialist.md— Expert sub-agent definition. Manages the full AI-DLC workflow: stage progression, artifact recording (audit.md,aidlc-state.md), phase transitions, and session resumption.skills/aidlc-workflow-guide/references/— Five phase-specific reference guides used by the skill at runtime:requirements-phase.md— Requirements analysis and user story generationdesign-phase.md— Application design, component decomposition, and Units of Workimplementation-phase.md— Code generation, CDK/IaC, and Mob Constructiontesting-phase.md— Test strategy, unit/integration tests, and coverage targetsrefactoring-phase.md— Refactoring triggers, code review, and technical debt trackingREADME.md— Added## AI-DLC Workflow Guide Skillsection with setup instructions for GitHub Copilot and Claude Code (macOS/Linux, Windows PowerShell, Windows CMD), directory structures, and verification steps.User experience
Before: No dedicated real-time companion skill existed; developers had to rely solely on the core workflow rules loaded via copilot-instructions.md / CLAUDE.md.
After: Developers can install the
aidlc-workflow-guideskill to get a proactive, phase-aware assistant. Theaidlc-specialistagent automatically activates at the right moments, generates artifacts, and keepsaidlc-state.mdandaudit.mdup to date throughout the development lifecycle.Checklist
Test Plan
skills/aidlc-workflow-guide/into.github/skills/of a test projectaidlc-specialistappears in the agent list"Using AI-DLC, let's begin requirements analysis"and verify the agent activatesaidlc-specialistis listed via/agentsnpx markdownlint-cli2 "skills/aidlc-workflow-guide/**/*.md" "README.md"— expect 0 errorsAcknowledgment
By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.