SDLC Agents 4 Enterprise

Your entire software team — in one extension.
9 AI agents. Full SDLC pipeline. Knowledge Base UI. Thin client for Code Intelligence backend.

Prerequisites: Backend Server Required

This extension is a thin client — it requires the Code Intelligence Backend server running on your machine.

Setup Steps

1. Start the backend server — published on npm, no source download needed:

# Run directly with npx (recommended)
npx sdlc-agent-4-enterprise-server

# Or install globally, then run
npm install -g sdlc-agent-4-enterprise-server
sdlc-agent-4-enterprise-server

# Server runs at http://localhost:48721
# Custom port: sdlc-agent-4-enterprise-server --port 9000

2. Install this extension (.vsix file):

# Build the extension
cd extension
npm ci
npm run esbuild
npx vsce package --no-dependencies

# Install into Kiro
kiro --install-extension sdlc-agents-4-enterprise-1.13.0.vsix

# Or VS Code
code --install-extension sdlc-agents-4-enterprise-1.13.0.vsix

3. Verify connection: Command Palette → "SDLC Agents: Settings" → Server Settings → Test Connection

Without the backend server, agent tools, KB panels, and indexing features will not work.

Quick Start

1. Ensure backend is running (http://localhost:48721/health → "healthy")
2. Open Command Palette: Ctrl+Shift+P → "SDLC Agents: Inject All Agents"
3. Select target IDE (Kiro, VSCode/Copilot, Claude Code, or Codex/OpenAI)
4. Check sidebar: SDLC AGENTS 4 ENTERPRISE → should show server connected
5. Give a Jira ticket to SM: @sm-agent KSA-14

Features

9 SDLC Agents

Usage

@sm-agent KSA-14              → Full pipeline (SM orchestrates everything)
@ba-agent KSA-14              → Just create BRD + FSD
@sa-agent KSA-14              → Just create TDD
@dev-agent KSA-14             → Implement code from TDD
@qa-agent KSA-14              → Create test plan + cases

Knowledge Base UI (5 Panels)

Open from sidebar → "Knowledge Base" section, or Command Palette → "KB".

Chat Panel

Built-in chat interface with LLM integration. Supports 135+ providers:

Configure: Command Palette → "SDLC Agents: Settings" → LLM Provider tab.

Code Intelligence

Commands

Settings

Configure in IDE settings (Ctrl+, → search "kiroSdlc") or via Settings panel:

Architecture (v2.0)

┌─────────────────────────────────────────────────┐
│  Extension (thin client)                         │
│  ┌──────────────┐  ┌─────────────────────────┐  │
│  │ Commands     │  │ Webview Panels           │  │
│  │ Chat Panel   │  │ (Graph, Dashboard, etc.) │  │
│  │ Tree View    │  │ Settings, Login          │  │
│  └──────┬───────┘  └──────────┬──────────────┘  │
│         │     HTTP :48721     │                  │
└─────────┼─────────────────────┼──────────────────┘
          │                     │
┌─────────▼─────────────────────▼──────────────────┐
│  Backend Server (separate process)                │
│  - 60+ MCP Tools                                 │
│  - SQLite + ONNX embeddings                      │
│  - Code indexing + AST parsing                   │
│  - Child MCP orchestration                       │
│  - Web admin portal                              │
└───────────────────────────────────────────────────┘

Key difference from v1.x: The extension no longer bundles its own MCP server. It connects to the standalone backend process via HTTP.

Troubleshooting

"Test Connection" loading forever

• Ensure backend is running: curl http://localhost:48721/health
• Check the URL in Settings matches the actual server address

Extension shows "disconnected"

• Backend server may have crashed — restart it: npx sdlc-agent-4-enterprise-server
• Or reconnect: Command Palette → "SDLC Agents: Reconnect to Backend"

Panels show blank/empty

• Panels require backend connection
• Verify backend health, then close and reopen the panel

Agent tools timeout

• Backend must be running and healthy
• Check backend logs for errors: look at the terminal where sdlc-agent-4-enterprise-server is running

Salesforce Support

The extension can index SFDX projects:

1. Command Palette → "SDLC Agents: Index Salesforce Project"
2. Extension detects sfdx-project.json in workspace
3. Counts and indexes: Apex classes, Triggers, Flows, Custom Objects, LWC components
4. All SF symbols become searchable via code intelligence tools

License

MIT

Changelog

v1.13.0 (2026-07-19)

• Presentation Servers — Added FastAPI (Python) + Next.js (React) presentation generation servers
• Electron Desktop App — Desktop wrapper with IPC and slide metadata
• Architecture Diagrams — Agent pipeline and architecture overview draw.io diagrams

v1.12.0 (2026-07-19)

• Version Bump — All packages and README files updated to v1.12.0
• Consistency Sync — Version badges, install commands, and changelogs aligned across root, backend, and extension READMEs

v1.11.0 (2026-07-18)

• SA4E-42: DatabaseAdapter Refactoring — Engine layer overhaul with DatabaseAdapter interface + SqliteDbAdapter implementation. Memory, graph, indexer modules refactored. 66 test files pass.
• SA4E-47: LLM Context Chain — Enhanced document indexing with context chain window, entity/actor/rule extraction, structured_map storage, full content extraction on ingest. 12 new test files.
• drawio Test Fixes — Export tests pass with content_base64 param; export-dependent tests skipped (requires drawio CLI).
• IndexerHttpClient — 30s HTTP timeout for extension KB operations.

v1.8.1 (2026-07-15)

• SA4E-38: Smart KB Ingest — New mem_smart_ingest + mem_smart_ingest_cleanup MCP tools for semantic evaluation before KB ingestion using local Ollama LLM.

v1.8.0 (2026-07-15)

• SA4E-36: Multi-tenant RBAC — Project isolation, per-user KB scoping, access group permissions, impersonation support in Admin Portal.

v1.7.0 (2026-07-15)

• SA4E-37: Health Check & Auto-Reconnect — Backend child MCP server connections now auto-recover from silent disconnections with exponential backoff. No extension changes required — backend handles transparently.

v1.5.0 (2026-07-13)

• SA4E-125: Pipeline Refactoring v2-v6 — Hardcoded → Data-Driven Architecture:
  • Index-based phase routing (currentPhaseIndex replaces order.indexOf())
  • Per-thread PipelineDefinition isolation with checkpoint/resume
  • Sandboxed hot-swap with 3-rule validation
  • resolvePhaseIndex() — pure function for self-healing index realignment
  • State size optimized to ~2-5KB per pipeline definition
  • Orphaned phase detection → pipeline pauses for human intervention
  • Skip/Cancel decisions via extended ApprovalDecision type
  • 3-Layer skip fix preventing infinite loops
  • Ghost Context Barrier — system ChatMessage injected on orphaned skip
  • LangGraph source restructured into core/, pipeline/, agents/, engine/, subgraphs/, workflow/, helpers/, hooks/, vscode/ modules
  • 13 architecture diagrams (draw.io + PNG export)
  • Full SDLC docs: BRD, FSD, TDD, STP, STC, UG, DPG

v1.3.0 (2026-07-09)

• Multi-IDE Agent Injection — "Inject All Agents" now shows IDE target picker:
  • Kiro (default): .kiro/agents/, .kiro/steering/, .kiro/hooks/
  • VSCode / GitHub Copilot: .github/agents/, .github/copilot-instructions.md
  • Claude Code: .claude/agents/, .claude/rules/, CLAUDE.md
  • Codex (OpenAI): AGENTS.md, agents/ subdirectory
• Pre-converted agent bundles — Each IDE gets properly formatted files (correct frontmatter, folder structure, hooks format)
• Codex/OpenAI conversion — New conversions/codex-openai/ with all 9 agents + subdirectory AGENTS.md
• Runtime picker removed — No longer asks to choose Python/NodeJS/Kotlin (bundled backend handles everything)
• IDE Adapter architecture — Strategy pattern with PreConvertedAdapter (copies pre-built files, no runtime conversion)
• LLM Provider Registry — 135 providers (from 6), data-driven provider-registry.ts, matching OpenCode/litellm ecosystem
• Settings dropdown dynamic — Provider picker generated from registry, grouped by Cloud/Enterprise/Gateway/Local
• SSRF fix — Localhost LLM providers (LM Studio, Ollama, vLLM, llama.cpp) no longer blocked by SSRF check
• TagAnalyzer health check — Backend checks if LLM provider is reachable before enabling; silent fallback to keyword tagging
• Updated CONVERSION-GUIDE.md and GAPS.md with Codex column

v1.2.1 (2026-07-08)

• Loop Engineering Guardrails — Inspired by loop-engineering:
  • Loop Constraints (path denylist, execution limits, push/merge safety)
  • Token Budget Tracking via KB (daily cap, 80% warning, 100% hard stop)
  • Circuit Breaker (closed/open/half-open, 30min cooldown, user override)
  • Run Log per ticket (append-only with tokens column)
  • Phased Autonomy (L1 report-only / L2 assisted / L3 unattended)
  • Failure Mode Catalog (7 patterns: infinite loop, verifier theater, token burn, etc.)
• Engineering Skills — Inspired by mattpocock/skills:
  • Domain Glossary via KB (BA extracts terms in Phase 1, all agents consume)
  • Two-Axis Code Review (Standards + Spec axes run parallel before QA)
  • DEV Bug Diagnosis Loop (6-phase: feedback loop → reproduce → hypothesise → instrument → fix → cleanup)
• 41 steering files bundled (up from 32)
• Install instructions updated for v1.2.1

v1.2.0 (2026-07-08)

• Local tools discoverable in MCP — stream_write_file and embed_image now appear in tools/list with description + inputSchema
• embed_image fully implemented — Processes markdown files: replaces local PNG/JPG image refs with base64 data URIs, outputs self-contained -embedded.md
• stream_write_file param fix — Now accepts both file_path (preferred) and path arguments
• injectLocalTools() in wrapper — Local tool definitions merged into backend tools/list responses (deduplicated)
• Install instructions updated for v1.2.0

v1.1.0

• Thin client architecture (extension → backend HTTP)
• 9 SDLC agents with Scrum Master orchestration
• Knowledge Base UI (5 panels)
• Chat panel with multi-LLM support
• Code intelligence (Symbol Search, Impact Analysis)
• Salesforce project indexing