iFacto Playbook VS Code Extension

Automated development environment setup for iFacto, Astena, O2Ti, and partner companies

Overview

The iFacto Playbook extension is designed for developers at iFactoBE, iFactoNL, iFactoFood, Astena, and O2Ti. It automates your complete development environment setup with company-specific configurations:

• Model Context Protocol (MCP) servers - Jira, Confluence, Azure DevOps, and more
• BC Code Intelligence - Company standards for Business Central development
• Prerequisites - Automatic Node.js, .NET SDK, and Azure CLI installation
• Authentication - Seamless Azure DevOps and Atlassian integration
• Company Profiles - One-click configuration for your organization

🚀 Getting Started<>

Step 1: Install the Extension

1. Open VS Code Extensions view (Ctrl+Shift+X)
2. Search for "iFacto Playbook"
3. Click Install

Or install from the VS Code Marketplace.

Step 2: Select Your Company Profile

Your company profile configures everything automatically - Azure DevOps organization, Atlassian sites, email domains, and which MCP servers to install.

1. Open Command Palette (Ctrl+Shift+P)
2. Run: iFacto: Select Company Profile
3. Choose your company:
   • iFactoBE - iFacto Belgium (@ifacto.be)
   • iFactoNL - iFacto Netherlands (@ifacto.nl)
   • iFactoFood - iFacto Food (@ifacto.be)
   • Astena - Astena (@astena.be)
   • O2Ti - O2Ti (@o2ti.be)

Why this matters: Each profile connects you to the right Jira/Confluence site, Azure DevOps organization, and issue tracker for your company.

Need to add a new company? See docs/PROFILE-QUICK-START.md for the 5-minute setup guide.

Step 3: Run the Setup Wizard

The setup wizard guides you through the complete installation process.

1. Open Command Palette (Ctrl+Shift+P)
2. Run: iFacto: Show Setup Wizard
3. Follow the prompts:

3a. Install Prerequisites

The wizard checks for and installs:

• Node.js 18+ - Required for MCP servers
• .NET SDK 8.0+ - Required for Business Central AL dependency analysis
• Azure CLI - Required for Azure DevOps authentication

Installation is automatic on Windows (winget), macOS (Homebrew), and Linux (package managers).

Troubleshooting:

• Permission errors: Run VS Code as Administrator (Windows) or use sudo
• Network issues: Check firewall and proxy settings
• Corporate restrictions: Contact IT for manual installation links

3b. Install MCP Servers

The wizard installs MCP servers based on your company profile:

API Token Setup: For Jira, Confluence, and Mantis, the wizard will:

1. Open the API token generation page in your browser
2. Prompt you to enter the generated token
3. Configure the MCP server automatically

3c. Setup BC Code Intelligence (Business Central Only)

For Business Central developers, this step configures company-wide development standards:

What BC Code Intelligence Provides:

• Company Guidelines - iFacto coding standards and patterns
• AI Specialists - Company-specific development experts
• Automatic Updates - Company standards stay current (checks every 4 hours)
• Workspace Integration - Custom agents and prompts in .github folder

Prerequisites:

• Azure CLI authenticated (az login)
• Access to your company's Azure DevOps organization

What Happens:

1. User-level config created at ~/.bc-code-intel/config.json
2. Company guidelines synced from Azure DevOps (BCCompanyGuidelines)
3. Agents and prompts copied to workspace .github folder
4. MCP server added to VS Code configuration

Automatic Updates: Status bar shows "$(cloud-download) BC Code Intel Update" when updates are available. Click to update instantly.

After Setup: You're ready to develop! The status bar and "iFacto Setup Status" view show your configuration health.

📋 Available Commands

⚙️ Configuration

🔐 Authentication

The extension uses Azure CLI for authentication (recommended):

az login

Alternative Methods:

• VS Code Azure Account extension (automatic)
• Personal Access Token (prompted if other methods fail)

Generate PAT at: https://dev.azure.com/iFactoAcademy/_usersSettings/tokens

🛠️ Troubleshooting

Prerequisites Won't Install

• Windows: Run VS Code as Administrator, or install manually from extension prompts
• macOS/Linux: Use sudo if package managers fail
• Corporate Networks: Contact IT if automatic installation is blocked

Authentication Fails

• Run az login in terminal
• Check Azure CLI is installed: az --version
• Verify you have access to your company's Azure DevOps organization

MCP Servers Not Working

• Check prerequisites: Node.js 18+, .NET SDK 8.0+, and Azure CLI must be installed
• Verify API tokens for Jira/Confluence/Mantis are correct
• Run iFacto: Validate Environment to diagnose issues

BC Code Intelligence Not Updating

• Ensure Azure CLI is authenticated: az login
• Check internet connection to Azure DevOps
• Manually trigger: iFacto: Check for BC Code Intel Updates

Need More Help? Check the "iFacto Setup Status" view in Explorer for detailed diagnostics.

🎉 What's New

v0.2.0 - January 2026

• Multi-company support with profiles for iFactoBE, iFactoNL, iFactoFood, Astena, O2Ti
• Region-specific configurations for Atlassian sites and email domains
• Streamlined setup wizard with guided installation

v0.1.0 - December 2025

• BC Code Intelligence - User-level MCP configuration for Business Central
• Automatic update detection with status bar notifications
• Prerequisites automation - One-click Node.js, .NET SDK, and Azure CLI installation
• Legacy migration from BCCopilotGuidance

See CHANGELOG.md for complete version history

🤝 Contributing

Want to add a new company profile or contribute to the extension?

See CONTRIBUTING.md for:

• Development setup and architecture
• How to add company profiles (5-minute guide)
• Coding guidelines and best practices
• Testing and release process

📄 License

Internal use only - iFacto Academy and partner companies

🔗 Related Projects

• BCCompanyGuidelines - Company-specific BC development standards
• bc-code-intel - Business Central Code Intelligence MCP server
• iFacto Playbook - Complete development environment documentation

Built with ❤️ by the DevLead team to make developer onboarding effortless!