Align Developer Assistant --- VS Code Extension
AI-powered development, review, and automation toolkit for IFS Cloud
customizations.
The Align Developer Assistant extension enhances your IFS Cloud
development workflow by integrating:
- OpenAI GPT models
- Azure DevOps Pull Request analysis
- Rule-based code quality checks aligned with the IFS Tailoring
Guide
- Local CUST & CORE repository awareness
- Smart code suggestions, refactoring, & file reviews
- AI-driven customization planning + effort estimation
Designed specifically for IFS Cloud developers, this extension
transforms your CUST workspace into an intelligent, automated
development environment.
🚀 Features Overview
1. AI Code Review (Full File)
Right-click any customization file →
IFS Cloud: Review File (Tailoring Guide)
Generates a full Markdown QA report including: - LU/logic summary\
- Violations & severity\
- Tailoring Guide alignment\
- Recommended fixes\
- IFS Review Score (0--100)
2. AI Refactor Selection (In-Place)
Select any block of code → right-click:
IFS Cloud: Refactor Selection (In-Place)
AI rewrites only your selection, directly inside the file.
3. AI Suggest Changes (Side-by-Side)
IFS Cloud: Suggest Changes for Current File
Opens an improved version of your file in a separate tab---your original
file remains untouched.
4. Customization Planner + Effort Estimator
IFS Cloud: Plan Customization
Given a requirement, the AI produces: - High-level solution\
- Step-by-step implementation\
- Relevant LU/Projection/PLSQL files\
- Example code snippets\
- Junior vs Senior hour estimates\
- Auto-detection of related CUST files
5. Azure DevOps PR Review (AI-Based)
IFS Cloud: Review Azure DevOps Pull Request
The extension will: 1. Ask for PR number
2. Fetch PR metadata from Azure DevOps
3. Checkout the correct source branch locally
4. Identify all changed files
5. Compute diffs or load entire files
6. Run AI analysis
7. Produce a combined Markdown report
Supports:\
- Diff Only Review (fast, cheaper)\
- Full File Review (complete QA)
📂 Workspace Requirements
Open your CUST repository as the VS Code workspace root:
D:\ifs-customizations
│ .env ← REQUIRED
├─ cmod/
├─ shpord/
├─ fndbas/
└─ ...
The extension folder may live anywhere.
Only the CUST repo must be the workspace root.
🔧 Required .env (In Workspace Root)
Create a file named .env in your CUST workspace root:
# OpenAI Configuration
OPENAI_API_KEY=sk-xxxx
OPENAI_MODEL=gpt-4o-mini
# Local Repository Paths
CUST_REPO=D:\ifs-customizations
CORE_REPO=D:\ifs-core
# Azure DevOps Configuration
AZ_ORG=yourOrgName
AZ_PROJECT=yourProjectName
AZ_REPO_ID=yourRepoIdGuid
AZ_PAT=yourAzurePAT
The extension validates all required variables before running.
📘 How to Obtain Each .env Variable
🧠 OPENAI_API_KEY
- https://platform.openai.com\
- Login → API Keys\
- Create new key → paste into
.env
💾 Repository Paths
CUST_REPO=D:\Customer\IFS\cust
CORE_REPO=D:\Customer\IFS\core
🔐 Azure DevOps
AZ_PAT
- https://dev.azure.com/``{=html}/_usersSettings/tokens\
- New Token\
- Scopes:
- Code → Read\
- Pull Requests → Read\
- Copy → paste into
.env
AZ_ORG & AZ_PROJECT
From DevOps URL:
https://dev.azure.com/<ORG>/<PROJECT>/_git/<REPO>
AZ_REPO_ID
Use browser DevTools or REST API:
GET https://dev.azure.com/<ORG>/<PROJECT>/_apis/git/repositories?api-version=7.1-preview.1
🖥 Commands
| Command | Purpose |
|--------|---------|
| IFS Cloud: Suggest Changes for Current File | GPT-powered rewrite (side-by-side) |
| IFS Cloud: Refactor Selection (In-Place) | Refactors only the selected code |
| IFS Cloud: Review File (Tailoring Guide) | Full file QA |
| IFS Cloud: Plan Customization | Generates solution steps + effort estimate |
| IFS Cloud: Review Azure DevOps Pull Request | Reviews PR diff or full files |
Ways to execute commands,
Ctrl + Shift + P and paste in the command
Right click on a file through the File Explorer
Right click on a file through the File Editor (Highlight area for a focused review)
⚠ Troubleshooting
OPENAI_API_KEY missing
Add it to .env.
No diffs detected
Ensure branch exists locally:
git fetch
git checkout feature/mybranch
git pull
🎉 You're Ready!
Enhance your IFS Cloud workflow with: - Faster PR reviews\
- Tailoring Guide--aligned output\
- AI refactoring & suggestions\
- Consistent standards
