agentic-sdlc 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 (98) hide show
  1. package/.agent/ide-integration/README.md +298 -0
  2. package/.agent/ide-integration/aider-commands.md +40 -0
  3. package/.agent/ide-integration/cline-config.json +108 -0
  4. package/.agent/ide-integration/cursor-rules.md +63 -0
  5. package/.agent/ide-integration/github-copilot-instructions.md +75 -0
  6. package/.agent/ide-integration/vscode-commands.json +190 -0
  7. package/.agent/ide-integration/windsurf-cascade.md +125 -0
  8. package/.agent/knowledge-base/README.md +202 -0
  9. package/.agent/knowledge-base/architecture/.gitkeep +1 -0
  10. package/.agent/knowledge-base/bugs/.gitkeep +1 -0
  11. package/.agent/knowledge-base/features/.gitkeep +1 -0
  12. package/.agent/knowledge-base/index.md +202 -0
  13. package/.agent/knowledge-base/performance/.gitkeep +1 -0
  14. package/.agent/knowledge-base/platform-specific/.gitkeep +1 -0
  15. package/.agent/knowledge-base/security/.gitkeep +1 -0
  16. package/.agent/legacy/roles/designer.md +311 -0
  17. package/.agent/legacy/roles/dev.md +177 -0
  18. package/.agent/legacy/roles/devops.md +146 -0
  19. package/.agent/legacy/roles/orchestrator.md +339 -0
  20. package/.agent/legacy/roles/pm.md +120 -0
  21. package/.agent/legacy/roles/po.md +89 -0
  22. package/.agent/legacy/roles/qa.md +108 -0
  23. package/.agent/legacy/roles/reporter.md +70 -0
  24. package/.agent/legacy/roles/sa.md +118 -0
  25. package/.agent/legacy/roles/seca.md +112 -0
  26. package/.agent/legacy/roles/stakeholder.md +111 -0
  27. package/.agent/legacy/roles/tester.md +129 -0
  28. package/.agent/rules/artifacts.md +58 -0
  29. package/.agent/rules/git-workflow.md +65 -0
  30. package/.agent/rules/global.md +154 -0
  31. package/.agent/rules/global.md.bak +154 -0
  32. package/.agent/rules/knowledge-base.md +45 -0
  33. package/.agent/templates/Design-Verification-Report-Template.md +67 -0
  34. package/.agent/templates/DevOps-Plan-Template.md +90 -0
  35. package/.agent/templates/Development-Log-Template.md +51 -0
  36. package/.agent/templates/Final-Approval-Report-Template.md +82 -0
  37. package/.agent/templates/Final-Project-Report-Template.md +280 -0
  38. package/.agent/templates/Knowledge-Entry-Template.md +164 -0
  39. package/.agent/templates/Master-Documentation-Template.md +269 -0
  40. package/.agent/templates/Phase-Report-Template.md +70 -0
  41. package/.agent/templates/Product-Backlog-Template.md +84 -0
  42. package/.agent/templates/Project-Plan-Template.md +79 -0
  43. package/.agent/templates/Security-Review-Report-Template.md +80 -0
  44. package/.agent/templates/System-Design-Spec-Template.md +170 -0
  45. package/.agent/templates/Test-Report-Template.md +97 -0
  46. package/.agent/templates/UIUX-Design-Spec-Template.md +280 -0
  47. package/.agent/templates/definition-of-done.md +151 -0
  48. package/.agent/templates/incident-response.md +111 -0
  49. package/.agent/usage.md +653 -0
  50. package/.agent/workflows/auto.md +35 -0
  51. package/.agent/workflows/brain.md +56 -0
  52. package/.agent/workflows/dev.md +30 -0
  53. package/.agent/workflows/devops.md +28 -0
  54. package/.agent/workflows/kb-search.md +22 -0
  55. package/.agent/workflows/pm.md +42 -0
  56. package/.agent/workflows/po.md +21 -0
  57. package/.agent/workflows/qa.md +31 -0
  58. package/.agent/workflows/reporter.md +21 -0
  59. package/.agent/workflows/sa.md +51 -0
  60. package/.agent/workflows/seca.md +21 -0
  61. package/.agent/workflows/stakeholder.md +26 -0
  62. package/.agent/workflows/tester.md +21 -0
  63. package/.agent/workflows/uiux.md +38 -0
  64. package/.cursorrules +49 -0
  65. package/.env.template +10 -0
  66. package/.github/ISSUE_TEMPLATE/bug_report.yml +47 -0
  67. package/.github/ISSUE_TEMPLATE/config.yml +8 -0
  68. package/.github/ISSUE_TEMPLATE/feature_request.yml +33 -0
  69. package/.github/ISSUE_TEMPLATE/security_alert.yml +28 -0
  70. package/.github/ISSUE_TEMPLATE/task_implementation.yml +37 -0
  71. package/.github/copilot-instructions.md +60 -0
  72. package/CHANGELOG.md +13 -0
  73. package/README.md +136 -0
  74. package/bin/cli.js +104 -0
  75. package/bin/commands/create.js +96 -0
  76. package/bin/commands/help.js +69 -0
  77. package/bin/commands/ide.js +116 -0
  78. package/bin/commands/init-kb.js +74 -0
  79. package/bin/commands/install.js +68 -0
  80. package/bin/commands/list.js +35 -0
  81. package/bin/graph_brain.py +86 -0
  82. package/bin/sync_github.py +75 -0
  83. package/bin/utils/args-parser.js +33 -0
  84. package/bin/utils/colors.js +21 -0
  85. package/bin/verify_neo4j.py +25 -0
  86. package/docs/OUTLINE.md +23 -0
  87. package/docs/architecture/brain.md +36 -0
  88. package/docs/architecture/neo4j-learning-queries.md +49 -0
  89. package/docs/guides/CLI-EXAMPLES.md +649 -0
  90. package/docs/guides/INTEGRATION-GUIDE.md +709 -0
  91. package/docs/guides/MCP-GUIDE.md +53 -0
  92. package/docs/guides/QUICK-START.md +104 -0
  93. package/docs/reports/comparison-leann-neo4j.md +49 -0
  94. package/docs/setup/github-management.md +37 -0
  95. package/docs/sprints/sprint-github-issues.md +36 -0
  96. package/docs/sprints/sprint-leann-integration.md +41 -0
  97. package/docs/sprints/sprint-neo4j-brain.md +38 -0
  98. package/package.json +16 -0
@@ -0,0 +1,58 @@
1
+ ---
2
+ description: Artifact and Naming Conventions
3
+ ---
4
+
5
+ # Artifact & Naming Conventions
6
+
7
+ ## Artifact Naming Convention
8
+ Use versioned names attached to the current Sprint:
9
+ | Artifact | Owner |
10
+ |----------|-------|
11
+ | `Project-Plan-Sprint-[N]-v*.md` | PM |
12
+ | `Product-Backlog-Sprint-[N]-v*.md` | PO |
13
+ | `UIUX-Design-Spec-Sprint-[N]-v*.md` | UIUX |
14
+ | `System-Design-Spec-Sprint-[N]-v*.md` | SA |
15
+ | `Design-Verification-Report-Sprint-[N]-v*.md` | QA |
16
+ | `Security-Review-Report-Sprint-[N]-v*.md` | SecA |
17
+ | `Development-Log-Sprint-[N]-v*.md` | DEV |
18
+ | `DevOps-Plan-and-Log-Sprint-[N]-v*.md` | DevOps |
19
+ | `Test-Report-Sprint-[N]-v*.md` | TESTER |
20
+ | `Phase-Report-Sprint-[N]-v*.md` | REPORTER |
21
+ | `Master-Documentation.md` | REPORTER |
22
+ | `Final-Project-Report.md` | REPORTER |
23
+ | `Final-Approval-Report.md` | STAKEHOLDER |
24
+
25
+ ## ⚠️ CRITICAL LOCATION RULE
26
+ ALL project artifacts MUST be created in the project workspace with organized structure based on **Sprint**:
27
+
28
+ **Base Directory:** `docs/sprints/sprint-[N]/`
29
+
30
+ | Category | Folder Path | Content Example | Owner |
31
+ |----------|-------------|-----------------|-------|
32
+ | Plans | `docs/sprints/sprint-[N]/plans/` | `Project-Plan-Sprint-[N]-v*.md`, `Product-Backlog-Sprint-[N]-v*.md` | PM, PO |
33
+ | Designs | `docs/sprints/sprint-[N]/designs/` | `System-Design-Spec-Sprint-[N]-v*.md`, `UIUX-Design-Spec-Sprint-[N]-v*.md` | SA, UIUX |
34
+ | Reviews | `docs/sprints/sprint-[N]/reviews/` | `Design-Verification-Report-Sprint-[N]-v*.md`, `Security-Review-Report-Sprint-[N]-v*.md` | QA, SecA |
35
+ | Logs | `docs/sprints/sprint-[N]/logs/` | `Development-Log-Sprint-[N]-v*.md`, `DevOps-Plan-and-Log-Sprint-[N]-v*.md` | DEV, DevOps |
36
+ | Tests | `docs/sprints/sprint-[N]/tests/` | `Test-Report-Sprint-[N]-v*.md` | TESTER |
37
+ | Reports | `docs/sprints/sprint-[N]/reports/` | `Phase-Report-Sprint-[N]-v*.md` | REPORTER |
38
+ | Global | `docs/global/reports/` | `Final-Project-Report.md`, `Final-Approval-Report.md` | REPORTER, STAKEHOLDER |
39
+ | Global | `docs/global/` | `Master-Documentation.md` | REPORTER |
40
+
41
+ **FORBIDDEN:** `.agent/` directory (reserved for instructions only)
42
+
43
+ ## Mandatory Documentation Tags
44
+ Every action must be tagged with appropriate hashtags:
45
+
46
+ | Category | Tags |
47
+ |----------|------|
48
+ | **Planning** | `#planning`, `#product-owner`, `#backlog` |
49
+ | **Design** | `#designing`, `#uiux-design` |
50
+ | **Verification** | `#verify-design`, `#security-review` |
51
+ | **Development** | `#development`, `#devops` |
52
+ | **Testing** | `#testing` |
53
+ | **Bug Fixes** | `#fixbug-critical`, `#fixbug-high`, `#fixbug-medium`, `#fixbug-low` |
54
+ | **Status** | `#blocked`, `#hotfix`, `#rollback` |
55
+ | **Deployment** | `#deployed-staging`, `#deployed-production` |
56
+ | **Research** | `#searching` |
57
+ | **Reporting** | `#reporting`, `#stakeholder-review` |
58
+ | **Knowledge** | `#knowledge-base`, `#lessons-learned` |
@@ -0,0 +1,65 @@
1
+ ---
2
+ description: Unified Git and Task Workflow
3
+ ---
4
+
5
+ # Git & Task Management Workflow
6
+
7
+ **Requirement:** All tasks must be tracked with Jira-like precision and committed atomically.
8
+
9
+ ## A. Task Board Logic
10
+ - All `Product-Backlog` items (User Stories) must be broken down into **Tasks** in the `Development-Log`.
11
+ - **Status Columns:** `Todo` | `In Progress` | `Review` | `Done`.
12
+ - **Assignal:** Every task must have an owner (e.g., `@DEV`, `@SA`).
13
+ - **Tracing:** Every completed task must link to a **Git Commit Hash**.
14
+
15
+ ## B. Atomic Commit Rule
16
+ - ⚠️ **DO NOT** commit all changes at once at the end of a sprint.
17
+ - **Workflow:**
18
+ 1. Pick a task from `Development-Log` (Mark as `In Progress`)
19
+ 2. Implement the code
20
+ 3. Verify locally
21
+ 4. **COMMIT IMMEDIATELY:** `git commit -m "[Task-ID] <Description>"`
22
+ 5. Update `Development-Log` (Mark as `Done` and add Commit Hash)
23
+ - This ensures a clean, traceable history and prevents "big bang" integration issues.
24
+
25
+ ## C. Definition of Done (DoD)
26
+ A feature/task is "Done" when ALL of the following are true:
27
+
28
+ ### For Development Tasks:
29
+ - [ ] Code implemented according to approved design specs
30
+ - [ ] Code follows project coding standards
31
+ - [ ] Local testing passed
32
+ - [ ] Evidence captured (screenshots/logs)
33
+ - [ ] Tagged with `#development`
34
+ - [ ] **Git Commit created and linked in Log**
35
+ - [ ] Handoff to TESTER completed
36
+
37
+ ### For Testing:
38
+ - [ ] All test cases executed
39
+ - [ ] No critical/high bugs open
40
+ - [ ] Evidence documented in Test-Report
41
+ - [ ] Tagged with `#testing`
42
+
43
+ ### For Deployment:
44
+ - [ ] CI/CD pipeline passing
45
+ - [ ] Staging environment verified
46
+ - [ ] Security checklist completed
47
+ - [ ] Tagged with `#deployed-staging` or `#deployed-production`
48
+
49
+ ### For Project Completion:
50
+ - [ ] All Must-Have features verified
51
+ - [ ] STAKEHOLDER approved
52
+ - [ ] Final documentation complete
53
+ - [ ] User notified
54
+
55
+ ## D. Automated Changelog Updates
56
+ - **Requirement:** Every commit MUST be followed by an update to CHANGELOG.md.
57
+ - **Format:**
58
+ ```markdown
59
+ - [YYYY-MM-DD] [Commit-Hash] [Type]: [Description] (@Author)
60
+ ```
61
+ - **Types:** Feature, Fix, Refactor, Docs, Chore, Test.
62
+
63
+ ## E. Release Summary Generation
64
+ - **Requirement:** After a feature is marked as 'Done' in the board or a 'Release' is triggered, the @REPORTER or @DEV MUST update the CHANGELOG.md with a summary of the version release.
65
+ - **Action:** Consolidate all atomic commits into a cohesive release entry.
@@ -0,0 +1,154 @@
1
+ # TeamLifecycle Global Rules & Conventions
2
+ (Version 1.4 – Strict IT SDLC Simulation for Google Antigravity)
3
+
4
+ **Last Updated:** 2026-01-01
5
+ **Maintainer:** Project Team
6
+
7
+ ---
8
+
9
+ ## Purpose
10
+ This document defines the mandatory rules, conventions, and lifecycle flow that EVERY agent in the TeamLifecycle workflow MUST follow without exception.
11
+ It ensures strict compliance, full traceability, auto-communication, and professional software development process.
12
+
13
+ ---
14
+
15
+ ## Strict SDLC Flow (NO SKIPPING PHASES – EVER)
16
+
17
+ ```
18
+ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────────────┐
19
+ │ 1. Planning │───▶│ 2. Plan Approval│───▶│ 3. Designing │
20
+ │ (PM) │ │ (User) │ │ (SA + UIUX + PO) │
21
+ └─────────────────┘ └─────────────────┘ └───────────┬─────────────┘
22
+
23
+
24
+ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────────────┐
25
+ │ 6. Testing │◀───│ 5. Development │◀───│ 4. Design Verification │
26
+ │ (TESTER) │ │ (DEV + Ops) │ │ (QA + SecA) │
27
+ └────────┬────────┘ └─────────────────┘ └─────────────────────────┘
28
+
29
+
30
+ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────────────┐
31
+ │ 7. Bug Fixing │───▶│ 8. Deployment │───▶│ 9. Reporting │
32
+ │ (DEV + Ops) │ │ (DevOps) │ │ (REPORTER) │
33
+ └─────────────────┘ └─────────────────┘ └───────────┬─────────────┘
34
+
35
+
36
+ ┌─────────────────┐ ┌─────────────────────────┐
37
+ │ ↩ Cycle Repeat │◀───│ 10. Final Review │
38
+ │ (if rejected) │ │ (STAKEHOLDER) │
39
+ └─────────────────┘ └───────────┬─────────────┘
40
+ │ ✅ Approved
41
+
42
+ ┌─────────────────────────┐
43
+ │ 11. Completion │
44
+ └─────────────────────────┘
45
+ ```
46
+
47
+ ### Phase Details:
48
+ 1. **Planning** (PM) – Gather requirements, create project plan
49
+ 2. **Plan Approval** (User) – Explicit user sign-off required
50
+ 3. **Designing** (SA + UIUX + PO in parallel) – Architecture, UI/UX, backlog prioritization
51
+ 4. **Design Verification** (QA + SecA in parallel) – Quality and security review
52
+ 5. **Development** (DEV + DevOps in parallel) – Implementation
53
+ 6. **Testing** (TESTER) – Functional, integration, E2E testing
54
+ 7. **Bug Fixing** (DEVs + DevOps) – Address identified issues
55
+ 8. **Deployment Prep** (DevOps) – CI/CD, staging, production readiness
56
+ 9. **Reporting & Documentation** (REPORTER) – Update CHANGELOG.md and create comprehensive reports
57
+ 10. **Final Review** (STAKEHOLDER) – Business approval
58
+ 11. **Repeat Cycle** (if needed) or **Completion**
59
+
60
+ ---
61
+
62
+ ## Cross-Role Dependencies
63
+
64
+ (See Role Descriptions for specific handoffs)
65
+
66
+ ---
67
+
68
+ ## Specialized Rule Sets
69
+
70
+ **You MUST refer to these additional rule files for specific domains:**
71
+
72
+ 1. **Artifacts & Naming:** `.agent/rules/artifacts.md`
73
+ - Covers: Naming conventions, folder structure, forbidden locations.
74
+ 2. **Git & Task Workflow:** `.agent/rules/git-workflow.md`
75
+ - Covers: Jira-style task tracking, atomic commits, Definition of Done.
76
+ 3. **Knowledge Base:** `.agent/rules/knowledge-base.md`
77
+ - Covers: When and how to create knowledge entries.
78
+
79
+ ---
80
+
81
+ ## Core Rules Every Agent MUST Obey
82
+
83
+ ### 1. Approval Gates
84
+ Critical phases require explicit approval:
85
+ | Gate | Approver | Artifact |
86
+ |------|----------|----------|
87
+ | Project Plan | User | Project-Plan-v*.md |
88
+ | Design | QA + SecA | Design-Verification-Report, Security-Review-Report |
89
+ | Final Delivery | STAKEHOLDER | Final-Approval-Report.md |
90
+
91
+ ### 2. Auto-Communication via @Tags
92
+ Always use @role tags to notify next agents.
93
+ - **Available roles:** @ORCHESTRATOR, @PM, @PO, @SA, @UIUX, @QA, @SECA, @DEV, @DEVOPS, @TESTER, @REPORTER, @STAKEHOLDER
94
+ - Example: `### Next Step: @SA - Start designing` or `@TESTER - Please test`
95
+ - **Orchestrator mode:** Add `--mode=full-auto` or `--mode=semi-auto` to enable automation
96
+
97
+ ### 3. No Scope Creep
98
+ - No new features or changes outside approved Project Plan
99
+ - Any change requires PM + PO to revise plan and get user re-approval
100
+
101
+ ### 4. Bug Priority Classification
102
+ | Priority | Tag | Criteria |
103
+ |----------|-----|----------|
104
+ | **Critical** | `#fixbug-critical` | Breaks core functionality, data loss, security exploit |
105
+ | **High** | `#fixbug-high` | Major feature broken, serious UX issue |
106
+ | **Medium** | `#fixbug-medium` | Works but with wrong behavior or poor UX |
107
+ | **Low** | `#fixbug-low` | Cosmetic, minor inconsistency |
108
+
109
+ ### 5. Cycle Repeat Triggers
110
+ Handled by REPORTER or STAKEHOLDER when:
111
+ - ❌ Unresolved critical/high bugs
112
+ - ❌ Rejected design or security review
113
+ - ❌ Stakeholder rejection
114
+ - ❌ Incomplete requirements coverage
115
+
116
+ **Action:** Tag `@PM` with reason → PM engages user → New plan version
117
+
118
+ ### 6. Transparency & Evidence
119
+ - Use screenshots, recordings, or browser artifacts for proof
120
+ - All agents must produce verifiable artifacts (logs, reports, diagrams)
121
+
122
+ ### 7. Global Handoff Template
123
+
124
+ Use this at the end of **every artifact**:
125
+
126
+ ```markdown
127
+ ### Next Step:
128
+ - [List of @tags and actions]
129
+ - [Clear status: ready for next phase / awaiting approval / cycle repeat]
130
+
131
+ #[appropriate-tags]
132
+ ```
133
+
134
+ ---
135
+
136
+ ## Final Note
137
+
138
+ > ⚠️ **ALL AGENTS MUST STRICTLY ADHERE TO THESE RULES.**
139
+ > Any deviation will break the workflow.
140
+ > If unsure, tag `@PM` for clarification.
141
+
142
+ #global-rules #reporting
143
+
144
+ ---
145
+
146
+ ## Changelog
147
+
148
+ | Version | Date | Changes |
149
+ |---------|------|---------|
150
+ | 1.4 | 2026-01-01 | Split large rules into artifacts.md, git-workflow.md, knowledge-base.md |
151
+ | 1.3 | 2026-01-01 | Added Task Management & Atomic Git Commit Rules |
152
+ | 1.2 | 2026-01-01 | Migrated to Native Agent structure (.agent/). Updated paths. |
153
+ | 1.1 | 2025-12-23 | Added PO role, new tags (#product-owner, #backlog, #blocked, #hotfix, #rollback, #deployed-*), Definition of Done, Cross-Role Dependencies diagram, Incident/Hotfix workflow, Changelog |
154
+ | 1.0 | Initial | Initial release with 10 roles and core SDLC flow |
@@ -0,0 +1,154 @@
1
+ # TeamLifecycle Global Rules & Conventions
2
+ (Version 1.4 – Strict IT SDLC Simulation for Google Antigravity)
3
+
4
+ **Last Updated:** 2025-12-31
5
+ **Maintainer:** Project Team
6
+
7
+ ---
8
+
9
+ ## Purpose
10
+ This document defines the mandatory rules, conventions, and lifecycle flow that EVERY agent in the TeamLifecycle workflow MUST follow without exception.
11
+ It ensures strict compliance, full traceability, auto-communication, and professional software development process.
12
+
13
+ ---
14
+
15
+ ## Strict SDLC Flow (NO SKIPPING PHASES – EVER)
16
+
17
+ ```
18
+ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────────────┐
19
+ │ 1. Planning │───▶│ 2. Plan Approval│───▶│ 3. Designing │
20
+ │ (PM) │ │ (User) │ │ (SA + UIUX + PO) │
21
+ └─────────────────┘ └─────────────────┘ └───────────┬─────────────┘
22
+
23
+
24
+ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────────────┐
25
+ │ 6. Testing │◀───│ 5. Development │◀───│ 4. Design Verification │
26
+ │ (TESTER) │ │ (DEV + Ops) │ │ (QA + SecA) │
27
+ └────────┬────────┘ └─────────────────┘ └─────────────────────────┘
28
+
29
+
30
+ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────────────┐
31
+ │ 7. Bug Fixing │───▶│ 8. Deployment │───▶│ 9. Reporting │
32
+ │ (DEV + Ops) │ │ (DevOps) │ │ (REPORTER) │
33
+ └─────────────────┘ └─────────────────┘ └───────────┬─────────────┘
34
+
35
+
36
+ ┌─────────────────┐ ┌─────────────────────────┐
37
+ │ ↩ Cycle Repeat │◀───│ 10. Final Review │
38
+ │ (if rejected) │ │ (STAKEHOLDER) │
39
+ └─────────────────┘ └───────────┬─────────────┘
40
+ │ ✅ Approved
41
+
42
+ ┌─────────────────────────┐
43
+ │ 11. Completion │
44
+ └─────────────────────────┘
45
+ ```
46
+
47
+ ### Phase Details:
48
+ 1. **Planning** (PM) – Gather requirements, create project plan
49
+ 2. **Plan Approval** (User) – Explicit user sign-off required
50
+ 3. **Designing** (SA + UIUX + PO in parallel) – Architecture, UI/UX, backlog prioritization
51
+ 4. **Design Verification** (QA + SecA in parallel) – Quality and security review
52
+ 5. **Development** (DEV + DevOps in parallel) – Implementation
53
+ 6. **Testing** (TESTER) – Functional, integration, E2E testing
54
+ 7. **Bug Fixing** (DEVs + DevOps) – Address identified issues
55
+ 8. **Deployment Prep** (DevOps) – CI/CD, staging, production readiness
56
+ 9. **Reporting & Documentation** (REPORTER) – Update CHANGELOG.md and create comprehensive reports
57
+ 10. **Final Review** (STAKEHOLDER) – Business approval
58
+ 11. **Repeat Cycle** (if needed) or **Completion**
59
+
60
+ ---
61
+
62
+ ## Cross-Role Dependencies
63
+
64
+ (See Role Descriptions for specific handoffs)
65
+
66
+ ---
67
+
68
+ ## Specialized Rule Sets
69
+
70
+ **You MUST refer to these additional rule files for specific domains:**
71
+
72
+ 1. **Artifacts & Naming:** `d:\dev\template-intructions\.agent\rules\artifacts.md`
73
+ - Covers: Naming conventions, folder structure, forbidden locations.
74
+ 2. **Git & Task Workflow:** `d:\dev\template-intructions\.agent\rules\git-workflow.md`
75
+ - Covers: Jira-style task tracking, atomic commits, Definition of Done.
76
+ 3. **Knowledge Base:** `d:\dev\template-intructions\.agent\rules\knowledge-base.md`
77
+ - Covers: When and how to create knowledge entries.
78
+
79
+ ---
80
+
81
+ ## Core Rules Every Agent MUST Obey
82
+
83
+ ### 1. Approval Gates
84
+ Critical phases require explicit approval:
85
+ | Gate | Approver | Artifact |
86
+ |------|----------|----------|
87
+ | Project Plan | User | Project-Plan-v*.md |
88
+ | Design | QA + SecA | Design-Verification-Report, Security-Review-Report |
89
+ | Final Delivery | STAKEHOLDER | Final-Approval-Report.md |
90
+
91
+ ### 2. Auto-Communication via @Tags
92
+ Always use @role tags to notify next agents.
93
+ - **Available roles:** @ORCHESTRATOR, @PM, @PO, @SA, @UIUX, @QA, @SECA, @DEV, @DEVOPS, @TESTER, @REPORTER, @STAKEHOLDER
94
+ - Example: `### Next Step: @SA - Start designing` or `@TESTER - Please test`
95
+ - **Orchestrator mode:** Add `--mode=full-auto` or `--mode=semi-auto` to enable automation
96
+
97
+ ### 3. No Scope Creep
98
+ - No new features or changes outside approved Project Plan
99
+ - Any change requires PM + PO to revise plan and get user re-approval
100
+
101
+ ### 4. Bug Priority Classification
102
+ | Priority | Tag | Criteria |
103
+ |----------|-----|----------|
104
+ | **Critical** | `#fixbug-critical` | Breaks core functionality, data loss, security exploit |
105
+ | **High** | `#fixbug-high` | Major feature broken, serious UX issue |
106
+ | **Medium** | `#fixbug-medium` | Works but with wrong behavior or poor UX |
107
+ | **Low** | `#fixbug-low` | Cosmetic, minor inconsistency |
108
+
109
+ ### 5. Cycle Repeat Triggers
110
+ Handled by REPORTER or STAKEHOLDER when:
111
+ - ❌ Unresolved critical/high bugs
112
+ - ❌ Rejected design or security review
113
+ - ❌ Stakeholder rejection
114
+ - ❌ Incomplete requirements coverage
115
+
116
+ **Action:** Tag `@PM` with reason → PM engages user → New plan version
117
+
118
+ ### 6. Transparency & Evidence
119
+ - Use screenshots, recordings, or browser artifacts for proof
120
+ - All agents must produce verifiable artifacts (logs, reports, diagrams)
121
+
122
+ ### 7. Global Handoff Template
123
+
124
+ Use this at the end of **every artifact**:
125
+
126
+ ```markdown
127
+ ### Next Step:
128
+ - [List of @tags and actions]
129
+ - [Clear status: ready for next phase / awaiting approval / cycle repeat]
130
+
131
+ #[appropriate-tags]
132
+ ```
133
+
134
+ ---
135
+
136
+ ## Final Note
137
+
138
+ > ⚠️ **ALL AGENTS MUST STRICTLY ADHERE TO THESE RULES.**
139
+ > Any deviation will break the workflow.
140
+ > If unsure, tag `@PM` for clarification.
141
+
142
+ #global-rules #reporting
143
+
144
+ ---
145
+
146
+ ## Changelog
147
+
148
+ | Version | Date | Changes |
149
+ |---------|------|---------|
150
+ | 1.4 | 2025-12-31 | Split large rules into artifacts.md, git-workflow.md, knowledge-base.md |
151
+ | 1.3 | 2025-12-31 | Added Task Management & Atomic Git Commit Rules |
152
+ | 1.2 | 2025-12-31 | Migrated to Native Agent structure (.agent/). Updated paths. |
153
+ | 1.1 | 2025-12-23 | Added PO role, new tags (#product-owner, #backlog, #blocked, #hotfix, #rollback, #deployed-*), Definition of Done, Cross-Role Dependencies diagram, Incident/Hotfix workflow, Changelog |
154
+ | 1.0 | Initial | Initial release with 10 roles and core SDLC flow |
@@ -0,0 +1,45 @@
1
+ ---
2
+ description: Knowledge Base System Rules
3
+ ---
4
+
5
+ # Knowledge Base System Rules
6
+
7
+ ## Purpose
8
+ The Knowledge Base stores lessons learned, bug patterns, difficult features, and solutions that required multiple attempts. This serves as project memory for future reference.
9
+
10
+ ## When to Create Entry
11
+ Create a knowledge entry when:
12
+ - Bug required 3+ attempts to fix
13
+ - Feature implementation was particularly challenging
14
+ - Solution was non-obvious or counter-intuitive
15
+ - Issue is likely to recur in similar projects
16
+ - Root cause analysis revealed important insights
17
+
18
+ ## Entry Naming
19
+ **Format:** `KB-[YYYY-MM-DD]-[###]-[short-title].md`
20
+
21
+ **Location:** `.agent/knowledge-base/[category]/[severity]/`
22
+
23
+ ## Categories
24
+ | Category | Folder | Description |
25
+ |----------|--------|-------------|
26
+ | Bugs | `knowledge-base/bugs/[severity]/` | Bug patterns and fixes |
27
+ | Features | `knowledge-base/features/[type]/` | Complex feature implementations |
28
+ | Architecture | `knowledge-base/architecture/` | Architecture decisions |
29
+ | Security | `knowledge-base/security/` | Security issues and solutions |
30
+ | Performance | `knowledge-base/performance/` | Performance optimizations |
31
+ | Platform | `knowledge-base/platform-specific/[platform]/` | Platform-specific issues |
32
+
33
+ ## Workflow
34
+ 1. **Create Entry:** Use `Knowledge-Entry-Template.md`
35
+ 2. **Document:** Include problem, root cause, solution, prevention
36
+ 3. **Tag:** Add appropriate tags for searchability
37
+ 4. **Update Index:** Add to `knowledge-base/index.md`
38
+ 5. **Notify:** Tag @REPORTER for review
39
+
40
+ ## Search Before Starting
41
+ Before implementing complex features or fixing bugs:
42
+ 1. Check `knowledge-base/index.md`
43
+ 2. Search by keywords, technology, or error messages
44
+ 3. Review similar entries
45
+ 4. Adapt solutions to current context
@@ -0,0 +1,67 @@
1
+ # Design Verification Report - Version [X]
2
+
3
+ ## Document Info
4
+ | Field | Value |
5
+ |-------|-------|
6
+ | Version | [X.0] |
7
+ | Date | [YYYY-MM-DD] |
8
+ | Author | @QA |
9
+ | Status | Pass / Fail / Conditional Pass |
10
+
11
+ ---
12
+
13
+ ## 1. Documents Reviewed
14
+ | Document | Version | Date Reviewed |
15
+ |----------|---------|---------------|
16
+ | Backend-Design-Spec | v[X] | [Date] |
17
+ | UIUX-Design-Spec | v[X] | [Date] |
18
+ | Project-Plan | v[X] | [Date] |
19
+
20
+ ## 2. Verification Summary
21
+ | Category | Status | Issues |
22
+ |----------|--------|--------|
23
+ | Completeness | ✅/⚠️/❌ | [Count] |
24
+ | Consistency | ✅/⚠️/❌ | [Count] |
25
+ | Testability | ✅/⚠️/❌ | [Count] |
26
+ | Requirements Coverage | ✅/⚠️/❌ | [Count] |
27
+
28
+ ## 3. Detailed Findings
29
+
30
+ ### 3.1 Completeness
31
+ | ID | Finding | Severity | Status |
32
+ |----|---------|----------|--------|
33
+ | QA-001 | [Finding description] | High/Med/Low | Open/Resolved |
34
+
35
+ ### 3.2 Consistency
36
+ | ID | Finding | Severity | Status |
37
+ |----|---------|----------|--------|
38
+ | QA-002 | [Finding description] | High/Med/Low | Open/Resolved |
39
+
40
+ ### 3.3 Testability
41
+ | ID | Finding | Severity | Status |
42
+ |----|---------|----------|--------|
43
+ | QA-003 | [Finding description] | High/Med/Low | Open/Resolved |
44
+
45
+ ## 4. Requirements Traceability
46
+ | Requirement | Design Reference | Covered |
47
+ |-------------|------------------|---------|
48
+ | [REQ-001] | Backend-Design 3.1 | ✅/❌ |
49
+ | [REQ-002] | UIUX-Design 3.2 | ✅/❌ |
50
+
51
+ ## 5. Recommendations
52
+ 1. [Recommendation 1]
53
+ 2. [Recommendation 2]
54
+
55
+ ## 6. Verdict
56
+ ☐ **PASS** - Design approved for development
57
+ ☐ **CONDITIONAL PASS** - Proceed with noted conditions
58
+ ☐ **FAIL** - Design requires revision before development
59
+
60
+ ---
61
+
62
+ ### Next Step:
63
+ - @SA @UIUX - Address findings (if any)
64
+ - @DEV - Begin development (if approved)
65
+ - @SECA - Complete security review
66
+
67
+ #verify-design
@@ -0,0 +1,90 @@
1
+ # DevOps Plan and Log - Version [X]
2
+
3
+ ## Document Info
4
+ | Field | Value |
5
+ |-------|-------|
6
+ | Version | [X.0] |
7
+ | Date | [YYYY-MM-DD] |
8
+ | Author | @DEVOPS |
9
+ | Status | Draft / Active |
10
+
11
+ ---
12
+
13
+ ## 1. Infrastructure Overview
14
+
15
+ ```
16
+ ┌─────────────────────────────────────────────────────────┐
17
+ │ Production │
18
+ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
19
+ │ │ CDN │───▶│ App │───▶│ DB │ │
20
+ │ └──────────┘ └──────────┘ └──────────┘ │
21
+ └─────────────────────────────────────────────────────────┘
22
+ ```
23
+
24
+ ## 2. Environments
25
+ | Environment | URL | Purpose |
26
+ |-------------|-----|---------|
27
+ | Development | localhost:5173 | Local development |
28
+ | Staging | [staging-url] | Pre-production testing |
29
+ | Production | [prod-url] | Live environment |
30
+
31
+ ## 3. CI/CD Pipeline
32
+
33
+ ```
34
+ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
35
+ │ Push │───▶│ Build │───▶│ Test │───▶│ Deploy │
36
+ └────────┘ └────────┘ └────────┘ └────────┘
37
+ ```
38
+
39
+ ### Pipeline Stages
40
+ | Stage | Tool | Duration | Status |
41
+ |-------|------|----------|--------|
42
+ | Build | [Tool] | ~[X]min | ✅/❌ |
43
+ | Test | [Tool] | ~[X]min | ✅/❌ |
44
+ | Deploy Staging | [Tool] | ~[X]min | ✅/❌ |
45
+ | Deploy Prod | [Tool] | ~[X]min | ✅/❌ |
46
+
47
+ ## 4. Deployment Checklist
48
+
49
+ ### Pre-Deployment
50
+ - [ ] All tests passing
51
+ - [ ] Security review approved
52
+ - [ ] Environment variables configured
53
+ - [ ] Database migrations ready
54
+ - [ ] Rollback plan documented
55
+
56
+ ### Post-Deployment
57
+ - [ ] Health check passing
58
+ - [ ] Smoke tests completed
59
+ - [ ] Monitoring alerts active
60
+ - [ ] Documentation updated
61
+
62
+ ## 5. Environment Variables
63
+ | Variable | Staging | Production | Notes |
64
+ |----------|---------|------------|-------|
65
+ | [VAR_NAME] | [Value] | [Value] | [Notes] |
66
+
67
+ ## 6. Monitoring & Alerts
68
+ | Metric | Threshold | Alert Channel |
69
+ |--------|-----------|---------------|
70
+ | Error Rate | > 1% | [Slack/Email] |
71
+ | Response Time | > 2s | [Slack/Email] |
72
+ | Uptime | < 99.9% | [Slack/Email] |
73
+
74
+ ## 7. Deployment Log
75
+
76
+ ### [Date] - v[X.X.X]
77
+ | Field | Value |
78
+ |-------|-------|
79
+ | Environment | Staging / Production |
80
+ | Status | ✅ Success / ❌ Failed |
81
+ | Duration | [X minutes] |
82
+ | Changes | [Brief description] |
83
+
84
+ ---
85
+
86
+ ### Next Step:
87
+ - @TESTER - Staging environment ready for testing
88
+ - @REPORTER - Deployment documentation complete
89
+
90
+ #devops #deployed-staging
@@ -0,0 +1,51 @@
1
+ # Development Log & Sprint Board - Version [X]
2
+
3
+ ## Document Info
4
+ | Field | Value |
5
+ |-------|-------|
6
+ | Version | [X.0] |
7
+ | Date | [YYYY-MM-DD] |
8
+ | Author | @DEV |
9
+ | Sprint | [Sprint #] |
10
+
11
+ ---
12
+
13
+ ## 1. Sprint Board (Jira-Style)
14
+
15
+ | ID | Task Description | Assignee | Status | Commit Hash |
16
+ |----|------------------|----------|--------|-------------|
17
+ | T-001 | [Implement Login Page] | @DEV1 | ✅ Done | `a1b2c3d` |
18
+ | T-002 | [Design Database Schema] | @SA | ✅ Done | `d4e5f6g` |
19
+ | T-003 | [Setup API Routes] | @DEV2 | 🔄 In Progress | - |
20
+ | T-004 | [Unit Tests for Auth] | @DEV1 | 📝 Todo | - |
21
+
22
+ ---
23
+
24
+ ## 2. Detailed Implementation Notes
25
+
26
+ ### [T-001] Implement Login Page
27
+ **Status:** ✅ Done
28
+ **Commit:** `a1b2c3d`
29
+ **Notes:**
30
+ - Used template from UIUX spec
31
+ - Validated input fields with Zod
32
+
33
+ ### [T-003] Setup API Routes
34
+ **Status:** 🔄 In Progress
35
+ **Notes:**
36
+ - Currently debugging middleware issue
37
+
38
+ ---
39
+
40
+ ## 3. Blockers & Issues
41
+ | ID | Description | Status | Action |
42
+ |----|-------------|--------|--------|
43
+ | BLK-001 | [Blocker description] | Open/Resolved | @[ROLE] to assist |
44
+
45
+ ---
46
+
47
+ ### Next Step:
48
+ - @TESTER - Items ready for testing: [T-001, T-002]
49
+ - @DEVOPS - Ready for staging deployment
50
+
51
+ #development