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 |
| Start free trial, subscribe, activate license keys, adjust seats, top up credits, manage billing | Azure DevOps → Organization settings → Raaghu Spec Kit |
| Approve or deny first-time users | Access Requests in the Spec Kit header |
| Assign or unassign seats | Organization settings → Raaghu Spec Kit → Users |
| Set shared org AI keys / enable Raaghu-hosted AI | Spec Kit hamburger → 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 Visual Studio Marketplace → Azure DevOps tab.
- Search for Raaghu Spec Kit → 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, License Keys, Credits, and Usage.
This billing hub is separate from the in-extension Settings dialog (hamburger menu), which is used for AI keys and command labels. 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 Access Requests from the Spec Kit header.
- Approve or Deny each request.
Details: Access Requests.
5. Assign seats
- Open Organization settings → Raaghu Spec Kit → Users.
- Under Available to assign, 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)
- BYOK: In the Spec Kit hub, hamburger → Settings → Organization Settings tab — add shared provider credentials for projects that use Admin mode.
- Hosted AI: Top up credits on the billing hub Subscription tab, then enable Raaghu-hosted AI on the in-extension AI Settings tab. Set spending caps on the Credits tab if needed.
Naming tip: the in-extension Organization Settings tab is for shared AI keys. The Azure DevOps Organization settings → Raaghu Spec Kit hub is for billing and seats.
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