Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/aws-samples/sample-well-architected-skills-and-steering/llms.txt

Use this file to discover all available pages before exploring further.

JetBrains Junie reads always-on guidelines from .junie/guidelines/*.md and discovers step-by-step skill playbooks from .junie/skills/. Installing both gives Junie persistent Well-Architected awareness in every conversation plus 11 structured assessment workflows it can follow on request — all from within your JetBrains IDE.

​
What gets installed

.junie/guidelines/well-architected.md

Always-on steering that applies the six Well-Architected pillars, design principles, and trade-off guidance to every Junie session in the project.

.junie/skills/ directory

Eleven skill subdirectories, each containing a SKILL.md playbook. Junie follows these step-by-step when you request a specific review, plan, or assessment.

​
Installation

1

Clone or download the source repo

If you haven’t already, clone the sample repository to a local path you can reference:
git clone https://github.com/aws-samples/sample-well-architected-skills-and-steering.git
2

Copy files into your project

Run the commands below from the root of your project directory, substituting path/to/this-repo with the actual clone location.
mkdir -p .junie/guidelines .junie/skills
cp path/to/this-repo/adapters/junie/guidelines.md .junie/guidelines/well-architected.md
cp -r path/to/this-repo/skills/* .junie/skills/
3

Verify the layout

Your project should now contain:
.junie/
  guidelines/
    well-architected.md
  skills/
    wa-review/SKILL.md
    security-assessment/SKILL.md
    reliability-improvement-plan/SKILL.md
    cost-optimization-review/SKILL.md
    performance-efficiency/SKILL.md
    sustainability-optimization/SKILL.md
    operational-excellence/SKILL.md
    migration-readiness/SKILL.md
    architecture-decision-record/SKILL.md
    wa-builder/SKILL.md
    wa-guardrails/SKILL.md

​
Install via script

If you prefer the one-command approach from a local clone, the install script handles directory creation and copying automatically: 
./install.sh ~/my-project --tool junie

​
Usage

Once the files are installed, Junie automatically applies the Well-Architected guidelines from .junie/guidelines/well-architected.md to every conversation. Invoke a specific skill by describing what you want: 
Run a Well-Architected review of this architecture.
Junie reads the guidelines file at session start and loads the matching .junie/skills/{skill-name}/SKILL.md when a structured assessment is requested.
Guidelines in .junie/guidelines/ are loaded for every session, so Well-Architected principles apply to all architecture discussions — not only explicit review requests. Ask for a “quick review” first to locate gaps before drilling into individual pillars.

​
Available skills

SkillWhat it does
wa-reviewFull 6-pillar review with prioritized findings report
security-assessmentDeep-dive into IAM, detection, data protection, incident response
reliability-improvement-planFind SPOFs, assess recovery, produce remediation plan
cost-optimization-reviewIdentify waste, right-sizing, pricing model improvements
performance-efficiencyResource selection, scaling, caching, optimization
sustainability-optimizationUtilization, architecture efficiency, carbon reduction
operational-excellenceCI/CD, observability, incident management, operational maturity
migration-readiness7 Rs assessment, dependency analysis, migration plan
architecture-decision-recordADR with WA pillar impact analysis
wa-builderLearn WA for your workload and generate visual artifacts
wa-guardrailsGenerate preventive controls (Config rules, SCPs, CI checks)

Build docs developers (and LLMs) love

Get started for freeTalk to us