feat: add Amazon Q Developer platform support (#521)

* feat: add Amazon Q Developer platform support

Add Amazon Q Developer as an install target so the skill can be installed
with `uipro init --ai amazonq` and removed via `uipro uninstall`.

Amazon Q loads every Markdown file under .amazonq/rules/ (recursively) as
always-on chat context, so only the rendered rule file goes there
(.amazonq/rules/ui-ux-pro-max.md). Data, scripts and the bundled
sub-skills go to .amazonq/skills/ via dataPath, the same split copilot
uses, so their reference docs are not pulled into every chat.

- new platform config src/ui-ux-pro-max/templates/platforms/amazonq.json
  (synced to cli/assets via sync:assets)
- register 'amazonq' in AIType, AI_TYPES, AI_FOLDERS, AI_TO_PLATFORM
- detect .amazonq workspace directories and describe the platform
- cover amazonq in the dry-run and template-script-paths e2e specs
- document Amazon Q Developer in README and cli/README

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* docs: note that Amazon Q only auto-loads the rule file

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
stanley 2026-10-08 22:06:45 -07:00 committed by GitHub
parent 1a2c459b35
commit 50d8a7de09
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
10 changed files with 68 additions and 5 deletions

View File

@ -289,6 +289,7 @@ uipro init --ai warp # Warp
uipro init --ai augment # Augment
uipro init --ai codewhale # CodeWhale
uipro init --ai zcode # ZCode
uipro init --ai amazonq # Amazon Q Developer
uipro init --ai universal # Universal / Agent Standard (.agents/skills/)
uipro init --ai all # All assistants
```
@ -333,7 +334,7 @@ If it is missing, install it yourself from [python.org](https://www.python.org/d
### Skill Mode (Auto-activate)
**Supported:** Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment, CodeWhale, ZCode
**Supported:** Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment, CodeWhale, ZCode, Amazon Q Developer
The skill activates automatically when you request UI/UX work. Just chat naturally:
@ -406,7 +407,7 @@ A plain ops dashboard ([before](https://skill-fixture-before.theroost.dev)) rest
For direct access to the design system generator:
> Note: If you installed via Continue, replace `.claude/skills/` with `.continue/skills/` in the commands below. For Droid (Factory), use `.factory/skills/`. For ZCode, use `.zcode/skills/`.
> Note: If you installed via Continue, replace `.claude/skills/` with `.continue/skills/` in the commands below. For Droid (Factory), use `.factory/skills/`. For ZCode, use `.zcode/skills/`. For Amazon Q Developer, use `.amazonq/skills/` (Amazon Q only auto-loads the rule at `.amazonq/rules/ui-ux-pro-max.md`; the data and scripts under `.amazonq/skills/` are files the rule points to).
```bash
# Generate design system with ASCII output

View File

@ -24,6 +24,7 @@ uipro init --ai qoder # Qoder
uipro init --ai gemini # Gemini CLI
uipro init --ai trae # Trae
uipro init --ai opencode # OpenCode
uipro init --ai amazonq # Amazon Q Developer
uipro init --ai universal # Universal / Agent Standard (.agents/skills/)
uipro init --ai all # All assistants

View File

@ -0,0 +1,19 @@
{
"platform": "amazonq",
"displayName": "Amazon Q Developer",
"installType": "full",
"folderStructure": {
"root": ".amazonq",
"skillPath": "rules",
"filename": "ui-ux-pro-max.md",
"dataPath": "skills/ui-ux-pro-max"
},
"scriptPath": "skills/ui-ux-pro-max/scripts/search.py",
"frontmatter": null,
"sections": {
"quickReference": false
},
"title": "ui-ux-pro-max",
"description": "UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.",
"skillOrWorkflow": "Skill"
}

View File

@ -1,4 +1,4 @@
export type AIType = 'claude' | 'cursor' | 'windsurf' | 'antigravity' | 'copilot' | 'kiro' | 'roocode' | 'codex' | 'qoder' | 'gemini' | 'trae' | 'opencode' | 'continue' | 'codebuddy' | 'droid' | 'kilocode' | 'warp' | 'augment' | 'codewhale' | 'zcode' | 'universal' | 'all';
export type AIType = 'claude' | 'cursor' | 'windsurf' | 'antigravity' | 'copilot' | 'kiro' | 'roocode' | 'codex' | 'qoder' | 'gemini' | 'trae' | 'opencode' | 'continue' | 'codebuddy' | 'droid' | 'kilocode' | 'warp' | 'augment' | 'codewhale' | 'zcode' | 'amazonq' | 'universal' | 'all';
export type ConcreteAIType = Exclude<AIType, 'all'>;
export type InstallType = 'full' | 'reference';
@ -43,7 +43,7 @@ export interface PlatformConfig {
skillOrWorkflow: string;
}
export const AI_TYPES: AIType[] = ['claude', 'cursor', 'windsurf', 'antigravity', 'copilot', 'roocode', 'kiro', 'codex', 'qoder', 'gemini', 'trae', 'opencode', 'continue', 'codebuddy', 'droid', 'kilocode', 'warp', 'augment', 'codewhale', 'zcode', 'universal', 'all'];
export const AI_TYPES: AIType[] = ['claude', 'cursor', 'windsurf', 'antigravity', 'copilot', 'roocode', 'kiro', 'codex', 'qoder', 'gemini', 'trae', 'opencode', 'continue', 'codebuddy', 'droid', 'kilocode', 'warp', 'augment', 'codewhale', 'zcode', 'amazonq', 'universal', 'all'];
// Legacy folder mapping for backward compatibility with ZIP-based installs.
// Note: .shared is included for platforms that used ZIP installs. Post-ZIP platforms
@ -69,5 +69,6 @@ export const AI_FOLDERS: Record<ConcreteAIType, string[]> = {
augment: ['.augment', '.shared'],
codewhale: ['.codewhale', '.shared'],
zcode: ['.zcode', '.shared'],
amazonq: ['.amazonq', '.shared'],
universal: ['.agents', '.shared'],
};

View File

@ -74,6 +74,9 @@ export function detectAIType(cwd: string = process.cwd()): DetectionResult {
if (existsSync(join(cwd, '.zcode'))) {
detected.push('zcode');
}
if (existsSync(join(cwd, '.amazonq'))) {
detected.push('amazonq');
}
// Suggest based on what's detected
let suggested: AIType | null = null;
@ -135,6 +138,8 @@ export function getAITypeDescription(aiType: AIType): string {
return 'CodeWhale (.codewhale/skills/)';
case 'zcode':
return 'ZCode (.zcode/skills/)';
case 'amazonq':
return 'Amazon Q Developer (.amazonq/rules/)';
case 'universal':
return 'Universal (.agents/skills/)';
case 'all':

View File

@ -55,6 +55,7 @@ const AI_TO_PLATFORM: Record<string, string> = {
augment: 'augment',
codewhale: 'codewhale',
zcode: 'zcode',
amazonq: 'amazonq',
universal: 'universal',
};

View File

@ -6,7 +6,7 @@ const DESCRIPTION =
test('all platform metadata uses one accurate activation description', async () => {
const configs = await loadAllPlatformConfigs();
expect(configs.size).toBe(21);
expect(configs.size).toBe(22);
for (const [platform, config] of configs) {
expect(config.description, platform).toBe(DESCRIPTION);
if (config.frontmatter?.description) {

View File

@ -43,6 +43,21 @@ test('dry-run plan supports the zcode platform layout', async () => {
expect(joined).toContain('Would copy 6 sub-skills (');
});
test('dry-run plan keeps amazonq data and sub-skills out of the rules folder', async () => {
const scratch = await mkdtemp(join(tmpdir(), 'uipro-dry-run-amazonq-'));
const actions = await planPlatformInstallActions(scratch, 'amazonq');
expect(actions[0]).toBe(
`Would write: ${join(scratch, '.amazonq', 'rules', 'ui-ux-pro-max.md')}`
);
expect(actions[1]).toBe(
`Would copy data + scripts: ${join(scratch, '.amazonq', 'skills', 'ui-ux-pro-max')}`
);
expect(actions[2]).toMatch(/^Would copy 6 sub-skills \(/);
expect(actions[2].endsWith(`: ${join(scratch, '.amazonq', 'skills')}`)).toBe(true);
});
test('dry-run plan for all platforms covers every unique layout', async () => {
const scratch = await mkdtemp(join(tmpdir(), 'uipro-dry-run-all-'));

View File

@ -8,6 +8,7 @@ const cases = [
['kiro', '.kiro/steering/ui-ux-pro-max/scripts/search.py'],
['droid', '.factory/skills/ui-ux-pro-max/scripts/search.py'],
['zcode', '.zcode/skills/ui-ux-pro-max/scripts/search.py'],
['amazonq', '.amazonq/skills/ui-ux-pro-max/scripts/search.py'],
] as const;
const SEARCH_COMMAND_COUNT = 17;

View File

@ -0,0 +1,19 @@
{
"platform": "amazonq",
"displayName": "Amazon Q Developer",
"installType": "full",
"folderStructure": {
"root": ".amazonq",
"skillPath": "rules",
"filename": "ui-ux-pro-max.md",
"dataPath": "skills/ui-ux-pro-max"
},
"scriptPath": "skills/ui-ux-pro-max/scripts/search.py",
"frontmatter": null,
"sections": {
"quickReference": false
},
"title": "ui-ux-pro-max",
"description": "UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.",
"skillOrWorkflow": "Skill"
}