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.
- package/.agent/ide-integration/README.md +298 -0
- package/.agent/ide-integration/aider-commands.md +40 -0
- package/.agent/ide-integration/cline-config.json +108 -0
- package/.agent/ide-integration/cursor-rules.md +63 -0
- package/.agent/ide-integration/github-copilot-instructions.md +75 -0
- package/.agent/ide-integration/vscode-commands.json +190 -0
- package/.agent/ide-integration/windsurf-cascade.md +125 -0
- package/.agent/knowledge-base/README.md +202 -0
- package/.agent/knowledge-base/architecture/.gitkeep +1 -0
- package/.agent/knowledge-base/bugs/.gitkeep +1 -0
- package/.agent/knowledge-base/features/.gitkeep +1 -0
- package/.agent/knowledge-base/index.md +202 -0
- package/.agent/knowledge-base/performance/.gitkeep +1 -0
- package/.agent/knowledge-base/platform-specific/.gitkeep +1 -0
- package/.agent/knowledge-base/security/.gitkeep +1 -0
- package/.agent/legacy/roles/designer.md +311 -0
- package/.agent/legacy/roles/dev.md +177 -0
- package/.agent/legacy/roles/devops.md +146 -0
- package/.agent/legacy/roles/orchestrator.md +339 -0
- package/.agent/legacy/roles/pm.md +120 -0
- package/.agent/legacy/roles/po.md +89 -0
- package/.agent/legacy/roles/qa.md +108 -0
- package/.agent/legacy/roles/reporter.md +70 -0
- package/.agent/legacy/roles/sa.md +118 -0
- package/.agent/legacy/roles/seca.md +112 -0
- package/.agent/legacy/roles/stakeholder.md +111 -0
- package/.agent/legacy/roles/tester.md +129 -0
- package/.agent/rules/artifacts.md +58 -0
- package/.agent/rules/git-workflow.md +65 -0
- package/.agent/rules/global.md +154 -0
- package/.agent/rules/global.md.bak +154 -0
- package/.agent/rules/knowledge-base.md +45 -0
- package/.agent/templates/Design-Verification-Report-Template.md +67 -0
- package/.agent/templates/DevOps-Plan-Template.md +90 -0
- package/.agent/templates/Development-Log-Template.md +51 -0
- package/.agent/templates/Final-Approval-Report-Template.md +82 -0
- package/.agent/templates/Final-Project-Report-Template.md +280 -0
- package/.agent/templates/Knowledge-Entry-Template.md +164 -0
- package/.agent/templates/Master-Documentation-Template.md +269 -0
- package/.agent/templates/Phase-Report-Template.md +70 -0
- package/.agent/templates/Product-Backlog-Template.md +84 -0
- package/.agent/templates/Project-Plan-Template.md +79 -0
- package/.agent/templates/Security-Review-Report-Template.md +80 -0
- package/.agent/templates/System-Design-Spec-Template.md +170 -0
- package/.agent/templates/Test-Report-Template.md +97 -0
- package/.agent/templates/UIUX-Design-Spec-Template.md +280 -0
- package/.agent/templates/definition-of-done.md +151 -0
- package/.agent/templates/incident-response.md +111 -0
- package/.agent/usage.md +653 -0
- package/.agent/workflows/auto.md +35 -0
- package/.agent/workflows/brain.md +56 -0
- package/.agent/workflows/dev.md +30 -0
- package/.agent/workflows/devops.md +28 -0
- package/.agent/workflows/kb-search.md +22 -0
- package/.agent/workflows/pm.md +42 -0
- package/.agent/workflows/po.md +21 -0
- package/.agent/workflows/qa.md +31 -0
- package/.agent/workflows/reporter.md +21 -0
- package/.agent/workflows/sa.md +51 -0
- package/.agent/workflows/seca.md +21 -0
- package/.agent/workflows/stakeholder.md +26 -0
- package/.agent/workflows/tester.md +21 -0
- package/.agent/workflows/uiux.md +38 -0
- package/.cursorrules +49 -0
- package/.env.template +10 -0
- package/.github/ISSUE_TEMPLATE/bug_report.yml +47 -0
- package/.github/ISSUE_TEMPLATE/config.yml +8 -0
- package/.github/ISSUE_TEMPLATE/feature_request.yml +33 -0
- package/.github/ISSUE_TEMPLATE/security_alert.yml +28 -0
- package/.github/ISSUE_TEMPLATE/task_implementation.yml +37 -0
- package/.github/copilot-instructions.md +60 -0
- package/CHANGELOG.md +13 -0
- package/README.md +136 -0
- package/bin/cli.js +104 -0
- package/bin/commands/create.js +96 -0
- package/bin/commands/help.js +69 -0
- package/bin/commands/ide.js +116 -0
- package/bin/commands/init-kb.js +74 -0
- package/bin/commands/install.js +68 -0
- package/bin/commands/list.js +35 -0
- package/bin/graph_brain.py +86 -0
- package/bin/sync_github.py +75 -0
- package/bin/utils/args-parser.js +33 -0
- package/bin/utils/colors.js +21 -0
- package/bin/verify_neo4j.py +25 -0
- package/docs/OUTLINE.md +23 -0
- package/docs/architecture/brain.md +36 -0
- package/docs/architecture/neo4j-learning-queries.md +49 -0
- package/docs/guides/CLI-EXAMPLES.md +649 -0
- package/docs/guides/INTEGRATION-GUIDE.md +709 -0
- package/docs/guides/MCP-GUIDE.md +53 -0
- package/docs/guides/QUICK-START.md +104 -0
- package/docs/reports/comparison-leann-neo4j.md +49 -0
- package/docs/setup/github-management.md +37 -0
- package/docs/sprints/sprint-github-issues.md +36 -0
- package/docs/sprints/sprint-leann-integration.md +41 -0
- package/docs/sprints/sprint-neo4j-brain.md +38 -0
- 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
|