Skip to content

feat: agent-driven setup — drop the manual steps#109

Open
DavidHache wants to merge 13 commits intoawslabs:mainfrom
DavidHache:main
Open

feat: agent-driven setup — drop the manual steps#109
DavidHache wants to merge 13 commits intoawslabs:mainfrom
DavidHache:main

Conversation

@DavidHache
Copy link
Copy Markdown

@DavidHache DavidHache commented Mar 6, 2026

Screenshot 2026-03-06 at 2 47 50 PM As AI agents get better at following instructions, it opens up simpler ways to solve problems we used to handle with scripts and commands.

Rather than maintaining platform-specific setup steps for every IDE, we now provide a single prompt and let the agent create the right config file for its environment.

Flattened aidlc-rules/ into one directory. Added SETUP.md with a two-step process: git submodule add, then paste the prompt. The agent handles the rest.

Issue #, if available:

Description of changes:

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.

As AI agents get better at following instructions, it opens up simpler
ways to solve problems we used to handle with scripts and commands.

Rather than maintaining platform-specific setup steps for every IDE,
we now provide a single prompt and let the agent create the right
config file for its environment.

Flattened aidlc-rules/ into one directory. Added SETUP.md with a
two-step process: git submodule add, then paste the prompt. The agent
handles the rest.
David Hache added 3 commits March 11, 2026 10:37
…lder structure

Workshops and tests depend on the original directory names. Reverts the
flatten from 94619af while keeping the AI-driven setup approach.

- Move rule details back to aidlc-rules/aws-aidlc-rule-details/
- Move core-workflow back to aidlc-rules/aws-aidlc-rules/
- Add .aidlc/aidlc-rules/aws-aidlc-rule-details/ as first path in
  core-workflow.md resolution, keeping legacy paths as fallbacks
- Update SETUP.md, README.md, CONTRIBUTING.md for restored structure
- Add "Do Not Rename or Move" guidance to CONTRIBUTING.md
- Update submodule URL to awslabs/aidlc-workflows.git
@DavidHache DavidHache changed the title feat: agent-driven setup — flatten rules, drop the manual steps feat: agent-driven setup — drop the manual steps Mar 11, 2026
@DavidHache DavidHache requested review from a team as code owners March 12, 2026 16:05
@harmjeff
Copy link
Copy Markdown
Contributor

2 Requested changes:

  1. Add setup to the main README.md after the Kiro (top) instructions
  2. Retain the old school instructions (manual) and add the AI setup as another option, in the navigation add AI Installation as an option after Kiro with an "Experimental" prefix

@DavidHache
Copy link
Copy Markdown
Author

2 Requested changes:

1. Add setup to the main README.md after the Kiro (top) instructions

2. Retain the old school instructions (manual) and add the AI setup as another option, in the navigation add AI Installation as an option after Kiro with an "Experimental" prefix

Done.

harmjeff
harmjeff previously approved these changes Mar 16, 2026
Copy link
Copy Markdown
Contributor

@harmjeff harmjeff left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As a mainline (not versioned) head it is fine. More testing is necessary to determine if this approach is universal before we reture the old onstructions.

Kalindi-Dev
Kalindi-Dev previously approved these changes Mar 30, 2026
Copy link
Copy Markdown
Contributor

@Kalindi-Dev Kalindi-Dev left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.

@Kalindi-Dev
Copy link
Copy Markdown
Contributor

@DavidHache Please modify the contributor statement for PR checks

Copy link
Copy Markdown
Member

@scottschreckengaust scottschreckengaust left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not inclinded

@scoropeza
Copy link
Copy Markdown
Contributor

SETUP.md file is called out in CHANGELOG, which is inaccurate. Need to update it with latest file structure and changes done.

Also, I'm against using 'git submodule update --remote .aidlc', as this bypasses our releases. During workshops we guide attendees into using Releases as opposed to pull from main, we should push agents to not bypass this. Never pull directly from main

…I-assisted setup

Replace the git submodule approach with a GitHub API-based release
download. The agent now queries the latest release, downloads the
versioned zip asset, and extracts the rules — no .gitmodules or
submodule tracking needed. Revert CHANGELOG.md to upstream.
@DavidHache DavidHache dismissed stale reviews from Kalindi-Dev and harmjeff via c472b6f April 1, 2026 19:00
@github-actions github-actions bot added documentation Improvements or additions to documentation rules labels Apr 1, 2026
David Hache and others added 2 commits April 1, 2026 15:08
Update path fallback labels from definitive platform assignments to
"typical with" hints, and add explicit note that resolution order
applies regardless of IDE or setup method used.
Co-authored-by: Scott Schreckengaust <[email protected]>
Copy link
Copy Markdown
Contributor

@harmjeff harmjeff left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Required changes made

@scoropeza
Copy link
Copy Markdown
Contributor

It now LGTM.

@harmjeff harmjeff enabled auto-merge April 2, 2026 13:13
Copy link
Copy Markdown
Member

@scottschreckengaust scottschreckengaust left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove CHANGELOG.md

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove changes to this file

Removed extra line.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation rules

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants