@akm1923main/init-project 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/QUICKSTART_CREATE_AI_PROJECT.md +52 -0
  2. package/README.md +48 -0
  3. package/index.js +219 -0
  4. package/package.json +24 -0
  5. package/templates/02_Skills/Legacy_Prompts/Architecture.md +72 -0
  6. package/templates/02_Skills/Legacy_Prompts/Coding_Discipline.md +283 -0
  7. package/templates/02_Skills/Legacy_Prompts/Generate_prd.md +129 -0
  8. package/templates/02_Skills/Legacy_Prompts/IDEA.md +188 -0
  9. package/templates/02_Skills/Legacy_Prompts/Sharder.md +359 -0
  10. package/templates/02_Skills/agents/Architect.md +453 -0
  11. package/templates/02_Skills/agents/Business_Analyst.md +341 -0
  12. package/templates/02_Skills/agents/Deployment_Engineer.md +371 -0
  13. package/templates/02_Skills/agents/DevOps_Engineer.md +356 -0
  14. package/templates/02_Skills/agents/Documentation_Writer.md +371 -0
  15. package/templates/02_Skills/agents/Idea_Analyst.md +334 -0
  16. package/templates/02_Skills/agents/Master_Orchestrator.md +197 -0
  17. package/templates/02_Skills/agents/Performance_Engineer.md +316 -0
  18. package/templates/02_Skills/agents/Product_Manager.md +344 -0
  19. package/templates/02_Skills/agents/Refactor_Specialist.md +8 -0
  20. package/templates/02_Skills/agents/Security_Engineer.md +360 -0
  21. package/templates/02_Skills/agents/Staff_Engineer.md +306 -0
  22. package/templates/02_Skills/agents/Testing_Engineer.md +312 -0
  23. package/templates/02_Skills/workflows/architecture_generation_workflow.md +73 -0
  24. package/templates/02_Skills/workflows/business_analysis_workflow.md +70 -0
  25. package/templates/02_Skills/workflows/deployment_workflow.md +31 -0
  26. package/templates/02_Skills/workflows/devops_setup_workflow.md +30 -0
  27. package/templates/02_Skills/workflows/documentation_workflow.md +352 -0
  28. package/templates/02_Skills/workflows/idea_refinement_workflow.md +106 -0
  29. package/templates/02_Skills/workflows/performance_review_workflow.md +29 -0
  30. package/templates/02_Skills/workflows/prd_generation_workflow.md +83 -0
  31. package/templates/02_Skills/workflows/refactor_workflow.md +35 -0
  32. package/templates/02_Skills/workflows/security_audit_workflow.md +30 -0
  33. package/templates/02_Skills/workflows/task_execution_workflow.md +33 -0
  34. package/templates/02_Skills/workflows/task_generation_workflow.md +61 -0
  35. package/templates/02_Skills/workflows/testing_workflow.md +31 -0
  36. package/templates/02_Skills/workflows/workflow_governance_rules.md +112 -0
@@ -0,0 +1,129 @@
1
+ ```md
2
+ # 🚀 Production-Grade Agentic RAG System
3
+ ## (Qdrant + Groq GPT-OSS-120B + Modular Backend Architecture)
4
+
5
+ You are a **Senior AI Systems Architect and Production Backend Engineer**.
6
+
7
+ Your task is to design and implement a **fully production-grade Agentic RAG system** using:
8
+
9
+ - **Vector Database:** Qdrant (self-hosted/local)
10
+ - **LLM Provider:** Groq API
11
+ - **Model:** gpt-oss-120b
12
+ - **Backend Framework:** FastAPI (Python)
13
+ - **Architecture Pattern:** Agentic RAG (Planner + Tools + Memory + Validation)
14
+
15
+ ---
16
+
17
+ # 🔴 MANDATORY RULE
18
+
19
+ You must:
20
+
21
+ 1. **FIRST generate a complete, detailed PRD (Product Requirements Document).**
22
+ 2. Only after the PRD is complete and coherent, proceed to implementation.
23
+ 3. Do NOT generate toy code.
24
+ 4. Do NOT collapse modules.
25
+ 5. Do NOT simplify architecture.
26
+ 6. Everything must be production-ready.
27
+
28
+ ---
29
+
30
+ # PHASE 1 — PRODUCT REQUIREMENTS DOCUMENT (PRD)
31
+
32
+ Generate a complete, structured PRD with the following sections:
33
+
34
+ ---
35
+
36
+ ## 1️⃣ Executive Summary
37
+
38
+ - What system is being built
39
+ - Why Agentic RAG instead of traditional RAG
40
+ - Core system goals
41
+ - Explicit non-goals
42
+ - Key architectural principles
43
+
44
+ ---
45
+
46
+ ## 2️⃣ Functional Requirements
47
+
48
+ System must support:
49
+
50
+ - Multi-hop reasoning
51
+ - Iterative retrieval loop
52
+ - ReAct-style agent loop
53
+ - Query rewriting
54
+ - Hybrid-retrieval-ready architecture (even if initially dense-only)
55
+ - Metadata filtering
56
+ - Tool usage framework
57
+ - Short-term memory
58
+ - Long-term memory (stored in Qdrant)
59
+ - Context compression
60
+ - Reranking support
61
+ - Structured citations
62
+ - Answer validation step
63
+ - Iteration hard limits
64
+ - Token budget enforcement
65
+ - Config-driven behavior
66
+ - Evaluation hooks
67
+ - Streaming support
68
+
69
+ ---
70
+
71
+ ## 3️⃣ Non-Functional Requirements
72
+
73
+ Define:
74
+
75
+ - Latency targets
76
+ - Cost control mechanisms
77
+ - Scalability strategy
78
+ - Modularity constraints
79
+ - Security requirements
80
+ - Observability requirements
81
+ - Rate limiting
82
+ - Prompt injection resistance
83
+ - Fault tolerance
84
+ - Retry logic
85
+ - Circuit breaker design
86
+
87
+ ---
88
+
89
+ ## 4️⃣ System Architecture (Deep Design)
90
+
91
+ Clearly define:
92
+
93
+ ### Online Query Flow
94
+
95
+ User
96
+ → API
97
+ → Router
98
+ → Planner
99
+ → Tool Execution Loop
100
+ → Retriever
101
+ → Memory
102
+ → Generator
103
+ → Validator
104
+ → Response
105
+
106
+ ### Offline Ingestion Flow
107
+
108
+ Document Loader
109
+ → Cleaning
110
+ → Chunking
111
+ → Embedding
112
+ → Qdrant Upsert
113
+
114
+ Define:
115
+
116
+ - Agent loop state schema
117
+ - Memory schema
118
+ - Retrieval schema
119
+ - Tool abstraction interface
120
+ - Failure handling logic
121
+ - Stop conditions
122
+
123
+ ---
124
+
125
+ ## 5️⃣ Backend Folder Structure (MANDATORY)
126
+
127
+ All backend code must live inside:
128
+
129
+ ```
@@ -0,0 +1,188 @@
1
+ # 💡 IDEA.md — PROJECT CONCEPT & ANALYSIS TEMPLATE
2
+
3
+ ## 🏷️ 1. Project Title
4
+
5
+ > Give your idea a concise, descriptive name.
6
+
7
+ Example: *Agentic Retrieval-Augmented Generation Platform (Agentic RAG System)*
8
+
9
+ **Title:**
10
+
11
+ ---
12
+
13
+ ## 📌 2. Primary Goal
14
+
15
+ > What are you trying to build?
16
+ > What is the core functionality or capability you expect?
17
+
18
+ **Goal Description:**
19
+
20
+ ---
21
+
22
+ ## 📍 3. Context & Background
23
+
24
+ > Describe the context of this idea. Why did you think of it?
25
+ > Include:
26
+
27
+ - Business problem
28
+ - Technical problem
29
+ - User pain points
30
+ - Current limitations in existing solutions
31
+
32
+ **Background:**
33
+
34
+ ---
35
+
36
+ ## 🎯 4. Target Users & Personas
37
+
38
+ > Who will use this system?
39
+ > List expected user roles and personas.
40
+
41
+ Example:
42
+
43
+ - AI Engineer
44
+ - Technical Writer
45
+ - Knowledge Worker
46
+ - System Admin
47
+
48
+ **Users & Personas:**
49
+
50
+ ---
51
+
52
+ ## 🧩 5. Expected Capabilities
53
+
54
+ > List the major capabilities expected from the system.
55
+
56
+ E.g.:
57
+
58
+ - Multi-hop reasoning
59
+ - Iterative retrieval
60
+ - Tool invocation
61
+ - Memory persistence
62
+
63
+ **Capabilities:**
64
+
65
+ ---
66
+
67
+ ## 🧪 6. Key Requirements (Functional)
68
+
69
+ > High-level functional requirements.
70
+
71
+ List them as bullet points.
72
+
73
+ **Functional Requirements:**
74
+
75
+ ---
76
+
77
+ ## 🔒 7. Key Constraints & Assumptions
78
+
79
+ > List constraints on environment, performance, reliability, cost, tech stack, etc.
80
+ > List your assumptions.
81
+
82
+ **Constraints:**
83
+ **Assumptions:**
84
+
85
+ ---
86
+
87
+ ## 📊 8. Success Metrics
88
+
89
+ > How will success be measured?
90
+ > List business & technical KPIs.
91
+
92
+ **Success Metrics:**
93
+
94
+ ---
95
+
96
+ ## 🔍 9. Open Questions
97
+
98
+ > List questions that need clarification before scoping.
99
+ > Example:
100
+
101
+ - Which model family?
102
+ - Which vector DB?
103
+ - On-prem vs Cloud?
104
+
105
+ **Open Questions:**
106
+
107
+ ---
108
+
109
+ ## 🚧 10. Risks & Concerns
110
+
111
+ > Possible technical, market, operational risks.
112
+ > Include concerns you already see.
113
+
114
+ **Risks:**
115
+
116
+ ---
117
+
118
+ ## 🔗 11. Dependencies
119
+
120
+ > Dependencies on:
121
+
122
+ - External APIs
123
+ - Data sources
124
+ - Third-party platforms
125
+ - Regulatory requirements
126
+ - Internal teams
127
+
128
+ **Dependencies:**
129
+
130
+ ---
131
+
132
+ ## 📈 12. Feasibility Indicators
133
+
134
+ > What makes you think this idea is feasible?
135
+ > Include:
136
+
137
+ - Prior work
138
+ - Known technologies
139
+ - Reference systems
140
+
141
+ **Feasibility:**
142
+
143
+ ---
144
+
145
+ ## 🧠 13. Enrichment Instructions (For LLM / Agent)
146
+
147
+ You must treat the above idea and do the following *before* generating a PRD:
148
+
149
+ 1. **Perform web research** to enrich this idea, including:
150
+
151
+ - Similar products / competitors
152
+ - Known architectural patterns
153
+ - Known challenges
154
+ - Relevant benchmarks
155
+ - Standard practices
156
+ 2. **Evaluate the idea for feasibility**, including:
157
+
158
+ - Technical feasibility
159
+ - Business feasibility
160
+ - Scalability considerations
161
+ 3. **Suggest improvements** where appropriate:
162
+
163
+ - Feature enhancements
164
+ - Risk mitigation strategies
165
+ - Alternate design options
166
+ 4. **Finalize a refined Idea Summary** that clearly explains:
167
+
168
+ - What the idea is
169
+ - Why it matters
170
+ - What success looks like
171
+ - What uncertainties remain
172
+ 5. **Output this refined interpretation in a well-structured summary**.
173
+
174
+ ---
175
+
176
+ ## 📝 14. Refined Idea (Leave blank, to be filled by agent)
177
+
178
+ > (The agent should produce a refined version here)
179
+
180
+ **Refined Idea Summary:**
181
+
182
+ ---
183
+
184
+ ## 🧾 15. Reference Links / Inputs
185
+
186
+ > Paste any URLs, diagrams, research links here.
187
+
188
+ **References:**
@@ -0,0 +1,359 @@
1
+ ---
2
+ # 🏆 ENTERPRISE TASK ORCHESTRATION TEMPLATE (GOD MODE 9.8)
3
+
4
+ ```md
5
+ # 🚀 ENTERPRISE TASK ORCHESTRATION TEMPLATE (GOD MODE 9.8)
6
+
7
+ You are a **Principal Engineer + Staff Architect + Technical Execution Lead**.
8
+
9
+ You will receive:
10
+
11
+ - Finalized PRD
12
+ - Finalized ARCHITECTURE.md
13
+
14
+ Your responsibility is to convert them into a fully traceable, dependency-aware, production-grade execution system.
15
+
16
+ ⚠️ Follow structure strictly.
17
+ ⚠️ No implementation code.
18
+ ⚠️ No sprint theory.
19
+ ⚠️ No process abstraction beyond defined sections.
20
+
21
+ This must feel like a real enterprise engineering execution artifact.
22
+ ---
23
+ # ⚠️ CRITICAL RULES
24
+
25
+ 1. Every task must be atomic and implementable.
26
+ 2. Tasks must map directly to Architecture components.
27
+ 3. Each task must reference:
28
+ - Related PRD Section
29
+ - Related Architecture Section
30
+ 4. Dependencies must be explicit.
31
+ 5. Dependencies must be classified:
32
+ - Hard (blocking)
33
+ - Soft (non-blocking)
34
+ 6. Critical path must be identified.
35
+ 7. Parallelizable tasks must be clearly marked.
36
+ 8. Every task must include:
37
+ - Objective
38
+ - Description
39
+ - Deliverables
40
+ - Dependencies (Hard/Soft)
41
+ - Risks
42
+ - Acceptance Criteria
43
+ - Validation Steps
44
+ - Definition of Done
45
+ - Estimated complexity (S/M/L)
46
+ - Estimated effort range
47
+ 9. No task may exceed atomic scope.
48
+ 10. No architecture section may remain without task coverage.
49
+ 11. The system must support resuming work after interruption.
50
+ 12. DEVELOPMENT_CHECKLIST must enable granular progress tracking.
51
+
52
+ ---
53
+
54
+ # 📁 OUTPUT STRUCTURE
55
+
56
+ Generate:
57
+
58
+ ```
59
+
60
+ Tasks/
61
+
62
+ ├── TASK_PLAN.md
63
+ ├── DEVELOPMENT_CHECKLIST.md
64
+ └── TASKS/
65
+ ├── TASK_001_<name>.md
66
+ ├── TASK_002_<name>.md
67
+ ├── TASK_003_<name>.md
68
+ └── ...
69
+
70
+ ```
71
+
72
+ Do not collapse structure.
73
+
74
+ ---
75
+
76
+ # 1️⃣ TASK_PLAN.md
77
+
78
+ Must contain:
79
+
80
+ ---
81
+
82
+ ## 1. Overview
83
+
84
+ - System Name
85
+ - PRD Version Reference
86
+ - Architecture Version Reference
87
+ - Total Task Count
88
+ - Total Phases
89
+ - Total Estimated Effort Range
90
+ - Architecture Components Covered
91
+
92
+ ---
93
+
94
+ ## 2. Development Phases
95
+
96
+ Phases must align to architecture layers:
97
+
98
+ - Phase 1 — Core Infrastructure
99
+ - Phase 2 — Data Layer
100
+ - Phase 3 — API Layer
101
+ - Phase 4 — Business Logic
102
+ - Phase 5 — Async / Events
103
+ - Phase 6 — Observability
104
+ - Phase 7 — Security Hardening
105
+ - Phase 8 — Performance Optimization
106
+ - Phase 9 — Production Readiness
107
+
108
+ For each phase include:
109
+
110
+ - Phase Objective
111
+ - Architecture Sections Covered
112
+ - Task IDs in this phase
113
+ - Entry Criteria
114
+ - Exit Criteria
115
+ - Phase Risk Level
116
+ - Cross-Phase Dependencies
117
+
118
+ ---
119
+
120
+ ## 3. Critical Path Analysis
121
+
122
+ Identify:
123
+
124
+ - Foundational tasks
125
+ - Blocking tasks
126
+ - Long-lead tasks
127
+ - High-risk tasks
128
+
129
+ Provide dependency graph:
130
+
131
+ ```mermaid
132
+ graph TD
133
+ TASK_001 --> TASK_004
134
+ TASK_004 --> TASK_009
135
+ TASK_009 --> TASK_015
136
+ ```
137
+
138
+ Explain:
139
+
140
+ * Why these are blocking
141
+ * Which phases depend on them
142
+ * What delays would impact system launch
143
+
144
+ ---
145
+
146
+ ## 4. Task Summary Table (Master Registry)
147
+
148
+ | Task ID | Title | Phase | Arch Ref | PRD Ref | Complexity | Effort | Hard Deps | Soft Deps | Critical | Parallelizable |
149
+ | ------- | ----- | ----- | -------- | ------- | ---------- | ------ | --------- | --------- | -------- | -------------- |
150
+
151
+ ---
152
+
153
+ ## 5. Architecture Coverage Validation
154
+
155
+ For each Architecture Component:
156
+
157
+ * Component Name
158
+ * Responsible Task IDs
159
+ * Validation Notes
160
+
161
+ No component should be unassigned.
162
+
163
+ ---
164
+
165
+ ## 6. Risk Distribution Overview
166
+
167
+ Summarize:
168
+
169
+ * High-risk tasks
170
+ * Integration-heavy tasks
171
+ * Performance-sensitive tasks
172
+ * Security-sensitive tasks
173
+
174
+ ---
175
+
176
+ # 2️⃣ DEVELOPMENT_CHECKLIST.md
177
+
178
+ This file must act as a live execution dashboard.
179
+
180
+ ---
181
+
182
+ ## Status Legend
183
+
184
+ * 🔲 Not Started
185
+ * 🟡 In Progress
186
+ * ✅ Completed
187
+ * 🚧 Blocked
188
+ * 🔴 Critical Path
189
+
190
+ ---
191
+
192
+ ## Task Tracking Table (Detailed)
193
+
194
+ | Task ID | Title | Status | Phase | Critical | Parallel | Owner | Start Date | End Date | Risk | Notes |
195
+ | ------- | ----- | ------ | ----- | -------- | -------- | ----- | ---------- | -------- | ---- | ----- |
196
+
197
+ ---
198
+
199
+ ## Phase Completion Summary
200
+
201
+ | Phase | Total Tasks | Completed | In Progress | Blocked | Remaining | % Complete |
202
+ | ----- | ----------- | --------- | ----------- | ------- | --------- | ---------- |
203
+
204
+ ---
205
+
206
+ ## Architecture Coverage Tracker
207
+
208
+ | Architecture Component | Implemented | Partially | Not Started |
209
+ | ---------------------- | ----------- | --------- | ----------- |
210
+
211
+ ---
212
+
213
+ ## Risk Tracker
214
+
215
+ | Task ID | Risk Level | Mitigation Strategy | Status |
216
+ | ------- | ---------- | ------------------- | ------ |
217
+
218
+ ---
219
+
220
+ ## Release Readiness Checklist
221
+
222
+ * [ ] All critical path tasks complete
223
+ * [ ] All architecture components implemented
224
+ * [ ] Security tasks complete
225
+ * [ ] Observability integrated
226
+ * [ ] Performance targets validated
227
+ * [ ] Failure scenarios tested
228
+ * [ ] Production readiness tasks complete
229
+ * [ ] Documentation finalized
230
+
231
+ ---
232
+
233
+ # 3️⃣ Individual Task Files (TASKS/TASK_XXX.md)
234
+
235
+ Each task file must strictly follow:
236
+
237
+ ---
238
+
239
+ # TASK_XXX: `<Title>`
240
+
241
+ Status: 🔲 Not Started
242
+ Phase: `<Phase Name>`
243
+ Critical Path: Yes / No
244
+ Parallelizable: Yes / No
245
+
246
+ ---
247
+
248
+ ## 1. Objective
249
+
250
+ Clear statement of what this task achieves.
251
+
252
+ ---
253
+
254
+ ## 2. Architecture Mapping
255
+
256
+ * Architecture Section:
257
+ * Component:
258
+ * PRD Section:
259
+
260
+ ---
261
+
262
+ ## 3. Detailed Description
263
+
264
+ Concise but comprehensive explanation of the work.
265
+
266
+ ---
267
+
268
+ ## 4. Deliverables
269
+
270
+ * Explicit artifacts
271
+ * Modules
272
+ * Configurations
273
+ * Schemas
274
+ * Documentation
275
+
276
+ ---
277
+
278
+ ## 5. Dependencies
279
+
280
+ ### Hard Dependencies
281
+
282
+ (List blocking tasks)
283
+
284
+ ### Soft Dependencies
285
+
286
+ (List related tasks)
287
+
288
+ ---
289
+
290
+ ## 6. Risks
291
+
292
+ * Technical
293
+ * Integration
294
+ * Performance
295
+ * Security
296
+
297
+ ---
298
+
299
+ ## 7. Acceptance Criteria
300
+
301
+ Clear measurable validation conditions.
302
+
303
+ ---
304
+
305
+ ## 8. Validation Steps
306
+
307
+ Step-by-step verification method to confirm correctness.
308
+
309
+ ---
310
+
311
+ ## 9. Definition of Done
312
+
313
+ * Scope fully implemented
314
+ * Integrated with related modules
315
+ * Acceptance criteria satisfied
316
+ * Reviewed
317
+ * Documented
318
+ * Tests (if applicable)
319
+ * Checklist updated
320
+
321
+ ---
322
+
323
+ ## 10. Estimated Complexity
324
+
325
+ S / M / L
326
+
327
+ Estimated Effort Range: (e.g., 1–2 days)
328
+
329
+ ---
330
+
331
+ ## 11. Implementation Notes (To Be Filled During Execution)
332
+
333
+ * Key decisions
334
+ * Constraints encountered
335
+ * Deviations (if approved)
336
+ * Follow-up considerations
337
+
338
+ ---
339
+
340
+ # FINAL INSTRUCTION
341
+
342
+ Using the provided PRD and Architecture:
343
+
344
+ Generate the full Tasks/ execution system.
345
+
346
+ Ensure:
347
+
348
+ * All architecture components are covered.
349
+ * No dependency cycles exist.
350
+ * Critical path is coherent.
351
+ * Tasks are atomic and well-defined.
352
+ * DEVELOPMENT_CHECKLIST is detailed enough to track progress granularly.
353
+ * Each individual task file is complete and executable.
354
+
355
+ This must feel like a real enterprise execution artifact suitable for long-term structured development.
356
+
357
+
358
+
359
+ ---