diff --git a/kits/debugpilot-ai/.gitignore b/kits/debugpilot-ai/.gitignore new file mode 100644 index 00000000..26916d32 --- /dev/null +++ b/kits/debugpilot-ai/.gitignore @@ -0,0 +1,5 @@ +node_modules +.next +.env +.env.local +dist \ No newline at end of file diff --git a/kits/debugpilot-ai/README.md b/kits/debugpilot-ai/README.md new file mode 100644 index 00000000..383790dc --- /dev/null +++ b/kits/debugpilot-ai/README.md @@ -0,0 +1,305 @@ +# DebugPilot AI + +AI-powered debugging workflow for faster incident triage and root cause analysis. + +--- + +## ๐Ÿš€ Live Demo + +**Production Deployment:** +[Live Demo](https://debugpilot-ai.vercel.app/) + +**GitHub Repository:** +[GitHub Repository](https://github.com/Yashyr190/debugpilot-ai) +--- + +## ๐Ÿ“Œ Overview + +DebugPilot AI is a lightweight AI-powered debugging assistant designed for developers working with modern full-stack applications. + +Developers often lose significant time manually reading logs, tracing stack errors, and identifying the actual subsystem responsible for failures. DebugPilot AI transforms raw logs, runtime exceptions, deployment failures, and API errors into structured debugging reports with actionable engineering insights. + +The goal of the project is not to replace developers, but to accelerate the first triage pass by converting noisy debugging data into a clean workflow-oriented report. + +--- + +## โ— Problem Statement + +Debugging production and development issues usually starts with scattered context: + +* Stack traces +* CI/CD failures +* Browser console errors +* Runtime exceptions +* API response failures +* Authentication issues +* Infrastructure logs + +Most debugging workflows are repetitive and unstructured. Developers spend time: + +* identifying the subsystem +* estimating severity +* finding root causes +* determining immediate next steps +* deciding what to check first + +This slows engineering velocity and increases debugging fatigue. + +--- + +## โœ… Solution + +DebugPilot AI provides a structured debugging workflow that converts raw technical failures into practical engineering reports. + +The application analyzes developer input and generates: + +* Error categorization +* Severity classification +* Likely subsystem detection +* Root cause analysis +* Immediate next debugging step +* Suggested fixes +* Debugging checklists +* Prevention guidance +* Confidence scoring + +Instead of returning long generic AI responses, the app focuses on concise, engineering-oriented outputs that resemble real incident triage workflows. + +--- + +## ๐Ÿง  Core Features + +### ๐Ÿ” AI-Powered Incident Triage + +Transforms stack traces, logs, and deployment failures into structured debugging reports. + +### โš ๏ธ Severity Detection + +Classifies issues into: + +* Low +* Medium +* High +* Critical + +### ๐Ÿ—๏ธ Likely Subsystem Identification + +Identifies the most relevant engineering layer involved in the issue. + +Examples: + +* Frontend API Layer +* React Rendering Layer +* Deployment Build Pipeline +* Backend Validation Layer +* Database Connection Layer + +### ๐Ÿ› ๏ธ Root Cause Analysis + +Provides concise and actionable debugging explanations. + +### ๐Ÿš€ Immediate Next Step + +Suggests the most practical first debugging action. + +### ๐Ÿ“‹ Debugging Checklist + +Generates operational debugging steps for developers. + +### ๐Ÿ›ก๏ธ Prevention Guidance + +Provides engineering practices to reduce recurring failures. + +### ๐Ÿ“Š Confidence Score + +Estimates confidence in the generated debugging report. + +### ๐ŸŽจ Modern Developer-Focused UI + +Built with a clean dark interface optimized for developer workflows. + +--- + +## โš™๏ธ Workflow + +```text +Input Error/Logs + โ†“ +Issue Classification + โ†“ +Severity Detection + โ†“ +Subsystem Identification + โ†“ +Root Cause Analysis + โ†“ +Fix Suggestions + โ†“ +Debugging Checklist + โ†“ +Prevention Guidance +``` + +--- + +## ๐Ÿงช Example Supported Issues + +DebugPilot AI can analyze: + +* React rendering failures +* API response errors +* Authentication token failures +* Deployment/build pipeline failures +* Database connection timeouts +* Runtime exceptions +* TypeScript build errors +* Infrastructure-related logs + +--- + +## ๐Ÿ–ผ๏ธ Screenshots + +### Landing Interface + +Screenshot 2026-05-12 at 6 44 22โ€ฏPM + +### Structured Debugging Report + +Screenshot 2026-05-12 at 6 42 01โ€ฏPM +Screenshot 2026-05-12 at 6 43 03โ€ฏPM + +### Deployment Failure Analysis + +Screenshot 2026-05-12 at 6 45 46โ€ฏPM + +--- + +## ๐Ÿ› ๏ธ Tech Stack + +### Frontend + +* Next.js 14 +* TypeScript +* Tailwind CSS + +### UI/UX + +* Glassmorphism-inspired interface +* Responsive layout +* Animated report transitions +* Loading shimmer states + +### AI Workflow + +* Structured debugging pipeline +* Heuristic fallback analyzer +* Confidence scoring system +* Workflow-oriented response generation + +--- + +## ๐Ÿงฑ Architecture + +The application uses a lightweight Next.js API route as the analysis boundary. + +If an AI API key is configured, the system can generate structured debugging responses using an LLM. If no key is configured, the app falls back to a local heuristic analyzer to ensure the application remains fully functional during demos and local development. + +This approach keeps the application: + +* lightweight +* reliable +* demo-friendly +* deployment-safe + +--- + +## ๐Ÿš€ Getting Started + +### Clone the repository + +```bash +git clone https://github.com/Yashyr190/debugpilot-ai.git +``` + +### Navigate into the project + +```bash +cd debugpilot-ai +``` + +### Install dependencies + +```bash +npm install +``` + +### Start development server + +```bash +npm run dev +``` + +Open: + +```text +http://localhost:3000 +``` + +--- + +## ๐Ÿ” Environment Variables + +Optional: + +```env +OPENAI_API_KEY=your_api_key +``` + +The application can also run completely without external AI APIs using the built-in local heuristic analysis mode. + +--- + +## ๐ŸŒฑ Future Improvements + +Potential future enhancements include: + +* GitHub repository context analysis +* CI/CD log ingestion +* Slack integration +* AI-generated pull request fixes +* Repository-aware debugging +* Multi-agent debugging workflows +* Real-time production incident monitoring + +--- + +## ๐ŸŽฏ Why This Project + +The focus of DebugPilot AI was not building a massive platform, but designing a focused developer workflow that feels practical, realistic, and immediately useful. + +The project emphasizes: + +* workflow design +* engineering usability +* structured outputs +* practical debugging +* AI-native product thinking + +--- + +## ๐Ÿ“น Demo Video + +(https://drive.google.com/file/d/1B6vfclYXRypmdNDDFDD16DtDiTtuYRL2/view?usp=sharing) + +--- + +## ๐Ÿ™Œ Acknowledgements + +Built as part of the Lamatic AgentKit Challenge. + +--- + +## ๐Ÿ“„ License + +MIT License + diff --git a/kits/debugpilot-ai/agent.md b/kits/debugpilot-ai/agent.md new file mode 100644 index 00000000..de6c6232 --- /dev/null +++ b/kits/debugpilot-ai/agent.md @@ -0,0 +1,14 @@ +# DebugPilot AI + +DebugPilot AI is an AI-powered debugging assistant designed for developers working with modern full-stack applications. + +It analyzes runtime errors, logs, deployment failures, and stack traces to provide structured debugging reports and actionable engineering insights. + +## Capabilities + +- Root cause analysis +- Runtime error interpretation +- Stack trace summarization +- Deployment issue diagnosis +- API failure analysis +- Suggested engineering fixes diff --git a/kits/debugpilot-ai/apps/.env.example b/kits/debugpilot-ai/apps/.env.example new file mode 100644 index 00000000..09d93431 --- /dev/null +++ b/kits/debugpilot-ai/apps/.env.example @@ -0,0 +1,3 @@ +LAMATIC_API_KEY= +LAMATIC_PROJECT_ID= +DEBUGPILOT_FLOW_ID= \ No newline at end of file diff --git a/kits/debugpilot-ai/apps/app/page.tsx b/kits/debugpilot-ai/apps/app/page.tsx new file mode 100644 index 00000000..1243776d --- /dev/null +++ b/kits/debugpilot-ai/apps/app/page.tsx @@ -0,0 +1,6 @@ +/** + * Minimal landing page for DebugPilot AI. + */ +export default function Page() { + return
DebugPilot AI
; +} \ No newline at end of file diff --git a/kits/debugpilot-ai/apps/next.config.mjs b/kits/debugpilot-ai/apps/next.config.mjs new file mode 100644 index 00000000..a58e2393 --- /dev/null +++ b/kits/debugpilot-ai/apps/next.config.mjs @@ -0,0 +1,4 @@ +/** @type {import('next').NextConfig} */ +const nextConfig = {}; + +export default nextConfig; \ No newline at end of file diff --git a/kits/debugpilot-ai/apps/package.json b/kits/debugpilot-ai/apps/package.json new file mode 100644 index 00000000..58933bec --- /dev/null +++ b/kits/debugpilot-ai/apps/package.json @@ -0,0 +1,20 @@ +{ + "name": "debugpilot-ai", + "private": true, + "scripts": { + "dev": "next dev", + "build": "next build", + "start": "next start", + "lint": "next lint" + }, + "dependencies": { + "next": "14.2.5", + "react": "18.2.0", + "react-dom": "18.2.0" + }, + "devDependencies": { + "typescript": "5.4.5", + "@types/react": "18.2.66", + "@types/node": "20.12.7" + } +} \ No newline at end of file diff --git a/kits/debugpilot-ai/apps/tsconfig.json b/kits/debugpilot-ai/apps/tsconfig.json new file mode 100644 index 00000000..e63490b7 --- /dev/null +++ b/kits/debugpilot-ai/apps/tsconfig.json @@ -0,0 +1,5 @@ +{ + "compilerOptions": { + "jsx": "preserve" + } +} \ No newline at end of file diff --git a/kits/debugpilot-ai/constitutions/default.md b/kits/debugpilot-ai/constitutions/default.md new file mode 100644 index 00000000..cf4392b5 --- /dev/null +++ b/kits/debugpilot-ai/constitutions/default.md @@ -0,0 +1,7 @@ +# DebugPilot AI Constitution + +- Prioritize actionable debugging insights +- Avoid hallucinating fixes +- Explain probable root causes clearly +- Focus on production-safe recommendations +- Prefer deterministic debugging approaches diff --git a/kits/debugpilot-ai/flows/debugpilot-flow.ts b/kits/debugpilot-ai/flows/debugpilot-flow.ts new file mode 100644 index 00000000..6b484f88 --- /dev/null +++ b/kits/debugpilot-ai/flows/debugpilot-flow.ts @@ -0,0 +1,67 @@ +/** + * Primary debugging workflow configuration for DebugPilot AI. + */ +export function getDebugPilotFlow(): Record { + return { + meta: { + id: "debugpilot-flow", + name: "DebugPilot Root Cause Analysis Flow", + description: "Minimal debugging workflow scaffold for DebugPilot AI.", + version: "1.0.0" + }, + + inputs: { + error: { + type: "string", + required: true + } + }, + + references: { + output: "debugLLMNode" + }, + + nodes: [ + { + nodeId: "triggerNode", + nodeType: "graphqlNode", + nodeName: "Debug Trigger", + values: { + responseType: "realtime", + schema: { + type: "object", + properties: { + error: { + type: "string" + } + }, + required: ["error"] + } + }, + needs: [] + }, + + { + nodeId: "debugLLMNode", + nodeType: "llmNode", + nodeName: "Debug Analysis", + values: { + model: "gpt-4", + temperature: 0.3, + topP: 0.9, + maxTokens: 1200, + prompt: + "Analyze the provided debugging issue and produce: Summary, Root Cause Analysis, Debugging Steps, Recommended Fixes, Reliability Risks, and Prevention Strategy." + }, + needs: ["triggerNode"] + } + ], + + edges: [ + { + source: "triggerNode", + target: "debugLLMNode" + } + ] + }; +} \ No newline at end of file diff --git a/kits/debugpilot-ai/lamatic.config.ts b/kits/debugpilot-ai/lamatic.config.ts new file mode 100644 index 00000000..ed195560 --- /dev/null +++ b/kits/debugpilot-ai/lamatic.config.ts @@ -0,0 +1,25 @@ +/** + * Configuration metadata for the DebugPilot AI kit. + */ +export default { + name: "DebugPilot AI", + description: "AI-powered debugging workflow for root cause analysis.", + version: "1.0.0", + type: "kit" as const, + author: { + name: "Yash Ramnani", + email: "yashyr190@gmail.com" + }, + tags: ["debugging", "ai", "developer-tools"], + steps: [ + { + id: "debugpilot-flow", + type: "mandatory" as const, + envKey: "DEBUGPILOT_FLOW_ID" + } + ], + links: { + demo: "https://debugpilot-ai.vercel.app", + github: "https://github.com/Lamatic/AgentKit/tree/main/kits/debugpilot-ai" + } +}; \ No newline at end of file