Admin Setup
Use this checklist if you are an organization administrator. You will install Spec Kit, subscribe, approve users, assign seats, and set org-level AI defaults so the team can work.
Prerequisites
- Azure DevOps organization administrator rights
- Ability to install marketplace extensions
- Billing access for Stripe checkout (subscription and credits), or a license key issued to your organization
What only admins can do
| Task | Where |
|---|---|
| Install the extension | Visual Studio Marketplace — Raaghu Spec Kit |
| Start free trial, subscribe, activate license keys, adjust seats, top up credits, manage billing | Azure DevOps → Organization settings → Raaghu Spec Kit |
| Approve or reject first-time users | Organization settings → Raaghu Spec Kit → Users → Pending requests |
| Assign or unassign seats | Organization settings → Raaghu Spec Kit → Users → Assigned users / Available to assign |
| Set org LLM connections and per-project AI permissions | Organization settings → Raaghu Spec Kit → Configurations |
| Enable Raaghu AI / project LLM for a project (after org permissions) | Spec Kit hamburger → Settings → LLM Settings |
Members can authorize and use the hub only after access approval (when required) and an assigned seat.
Steps
1. Install the extension
- Open the Raaghu Spec Kit listing on the Visual Studio Marketplace.
- Click Get → select your organization → Install.
- Confirm under Organization settings → Extensions → Installed.
Details: Installation and Launch.
2. Open the billing hub
- In Azure DevOps, open Organization settings.
- In the left menu, select Raaghu Spec Kit.
You should see tabs: Subscription, Users, Configurations, License Keys, and Raaghu AI Credits.
This hub is separate from the in-extension Settings dialog (hamburger menu), which is used for project LLM keys, Raaghu AI for the current project, and command labels. Org-wide connections live under Configurations. Details: Organization Settings.
3. Start a trial, subscribe, or activate a license key
Choose one path on the billing hub:
- Free trial (recommended for new orgs): On Subscription, eligible tenant admins see Choose Your Plan. Select Free Trial, then click Start Free Trial (up to 5 seats, no credit card required). Confirm the plan badge shows Free trial and Trial summary lists Trial ends on.
- Paid subscription: On Choose Your Plan, select Paid, set seats, click Subscribe Now (or use Subscribe for $…/month when trial is not available), and complete checkout (Professional Plan — $9 per seat / month). If you have a promotion code, enter it on the Stripe checkout page. Confirm status shows Active.
- License key: On License Keys, enter a key (
RAAGHU-XXXX-XXXX-XXXX), preview it, then Confirm & activate. Subscription then shows a License key badge and Expires on.
After a trial ends, keep access with paid checkout or a license key. If Choose Your Plan / Start Free Trial is missing, the org is not trial-eligible — use paid checkout or a license key instead.
See details in Organization Settings.
4. Approve access requests
- When users first authorize, they may submit an access request.
- Open Organization settings → Raaghu Spec Kit → Users → Pending requests.
- Approve or Reject each request (or select multiple and use Approve selected).
Details: Access Requests.
5. Assign seats
- Stay on Organization settings → Raaghu Spec Kit → Users.
- Open Available to assign, then click Assign seat for each person who should use Spec Kit.
- Assign a seat to yourself if you will use the hub.
Important: Approval alone is not enough — users also need an assigned seat.
6. Fund AI (optional but recommended)
- Org BYOK: On the billing hub → Configurations → Personal, click + Add LLM to add shared provider credentials. On the Project sub-tab, open a project and enable Use Organization AI, then assign connections under Assign AI Services.
- Project BYOK: On Configurations → Project, open a project and check Use Project AI so users can turn on project keys in hamburger → Settings → LLM Settings.
- Hosted AI: Top up credits on the Subscription tab or via Top up Raaghu AI credits on Raaghu AI Credits. On Configurations → Project, open a project and check Use Raaghu AI. Users then enable Raaghu AI under Settings → LLM Settings. Set spending caps on the Raaghu AI Credits tab if needed.
Naming tip: Azure DevOps Organization settings → Raaghu Spec Kit is for billing, seats, and Configurations. The in-extension Settings dialog is for the current project's LLM toggle, Raaghu AI, and Commands Mapping.
7. Smoke-test a project
- Open a project → Raaghu Spec Kit.
- Initialize Spec Kit once.
- Confirm chat can send a message (AI connected).
- Optionally run Your First Feature.
Next steps
- Share Quick Start with your team
- Your First Feature
- Troubleshooting