@deimoscloud/coreai 0.1.16 → 0.1.18
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/agents/_templates/master-context.md +76 -0
- package/agents/_templates/master-protocols.md +39 -0
- package/agents/android-engineer.md +3 -115
- package/agents/backend-engineer.md +3 -115
- package/agents/database-administrator.md +3 -115
- package/agents/devops-engineer.md +3 -115
- package/agents/frontend-engineer.md +3 -115
- package/agents/react-engineer.md +3 -115
- package/agents/react-native-engineer.md +3 -115
- package/agents/software-security-engineer.md +3 -115
- package/agents/sre-huawei-cloud-architect.md +3 -115
- package/agents/sre-iac-specialist.md +3 -115
- package/agents/sre-kubernetes-specialist.md +3 -115
- package/agents/sre-network-specialist.md +3 -115
- package/agents/wearos-engineer.md +3 -115
- package/dist/cli/index.js +209 -616
- package/dist/cli/index.js.map +1 -1
- package/dist/index.d.ts +35 -30
- package/dist/index.js +173 -590
- package/dist/index.js.map +1 -1
- package/package.json +2 -1
- package/skills/core/check-inbox/SKILL.md +37 -0
- package/skills/core/delegate/SKILL.md +61 -0
- package/skills/core/review/SKILL.md +57 -0
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
## Knowledge Library Structure
|
|
2
|
+
|
|
3
|
+
### Shared Context (Root - All Agents)
|
|
4
|
+
```
|
|
5
|
+
/KnowledgeLibrary/
|
|
6
|
+
├── context.txt # Current overall state, priorities, decisions, issues
|
|
7
|
+
├── architecture.txt # Current architecture state, decision changelog
|
|
8
|
+
└── prd.txt # Current product state, priorities, decisions, issues
|
|
9
|
+
```
|
|
10
|
+
> **Note:** Only @engineering-manager updates root context files. Provide updates via your completion summary.
|
|
11
|
+
|
|
12
|
+
**Remote Documentation:** ${remote.documentation}
|
|
13
|
+
|
|
14
|
+
### Personal Context
|
|
15
|
+
```
|
|
16
|
+
/KnowledgeLibrary/${agent.role}/
|
|
17
|
+
├── context/
|
|
18
|
+
│ └── current.txt # Your current state, priorities, decisions, issues
|
|
19
|
+
├── history/
|
|
20
|
+
│ └── [archived context files, timestamped]
|
|
21
|
+
├── inbox/
|
|
22
|
+
│ └── YYYYMMDD_HHMM-[agent-name]-[topic].md # Messages from other agents
|
|
23
|
+
├── outbox/
|
|
24
|
+
│ └── YYYYMMDD_HHMM-to-[agent-name]-[topic].md # Copies of sent messages
|
|
25
|
+
├── tech/
|
|
26
|
+
│ └── ${agent.tech_artifacts}
|
|
27
|
+
└── control/
|
|
28
|
+
├── objectives.txt # Current job objectives and goals
|
|
29
|
+
├── decisions.txt # Log of key decisions with rationale
|
|
30
|
+
├── dependencies.txt # Dependencies on other jobs
|
|
31
|
+
└── index.txt # Optional index of files/folders
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### Communication Conventions
|
|
35
|
+
- **Inbox message naming:** `YYYYMMDD_HHMM-[from-agent]-[topic].md`
|
|
36
|
+
- **Outbox message naming:** `YYYYMMDD_HHMM-to-[recipient]-[topic].md`
|
|
37
|
+
- **Processed messages:** Move handled inbox messages to `inbox/processed/` with prefix `PROCESSED_YYYYMMDD_HHMM_`
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## When Invoked
|
|
42
|
+
|
|
43
|
+
> **MANDATORY STARTUP PROTOCOL** - Execute before proceeding with any task.
|
|
44
|
+
|
|
45
|
+
### Session Context Check
|
|
46
|
+
|
|
47
|
+
First, determine if you have already loaded context in this session:
|
|
48
|
+
|
|
49
|
+
**If this is your FIRST invocation in this session** (no prior context loaded):
|
|
50
|
+
|
|
51
|
+
#### 1. Load Shared Context
|
|
52
|
+
- [ ] Read `/KnowledgeLibrary/context.txt` (local project state)
|
|
53
|
+
|
|
54
|
+
**Architecture & PRD (remote primary, local fallback):**
|
|
55
|
+
- [ ] Read architecture documentation from remote source (${remote.documentation})
|
|
56
|
+
- [ ] Read product requirements from remote source
|
|
57
|
+
- [ ] *Fallback if remote unavailable:* Read `/KnowledgeLibrary/architecture.txt` and `/KnowledgeLibrary/prd.txt`
|
|
58
|
+
|
|
59
|
+
#### 2. Load Personal Context
|
|
60
|
+
- [ ] Read `/KnowledgeLibrary/${agent.role}/context/current.txt`
|
|
61
|
+
- [ ] Check `/KnowledgeLibrary/${agent.role}/inbox/` for **unprocessed** messages (ignore `inbox/processed/`)
|
|
62
|
+
- [ ] Review `/KnowledgeLibrary/${agent.role}/control/objectives.txt`
|
|
63
|
+
- [ ] Review `/KnowledgeLibrary/${agent.role}/control/decisions.txt`
|
|
64
|
+
|
|
65
|
+
#### 3. Load Workflow Definitions
|
|
66
|
+
- [ ] Read `/KnowledgeLibrary/workflows.md` (mandatory workflow state machines)
|
|
67
|
+
|
|
68
|
+
Acknowledge: "Startup protocol complete. Full context loaded."
|
|
69
|
+
|
|
70
|
+
**If you have ALREADY loaded context in this session** (subsequent invocation):
|
|
71
|
+
|
|
72
|
+
- [ ] Check `/KnowledgeLibrary/${agent.role}/inbox/` for NEW messages only
|
|
73
|
+
|
|
74
|
+
Acknowledge: "Context already loaded. Checked inbox for new messages."
|
|
75
|
+
|
|
76
|
+
Then proceed with the task.
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
## Before Finishing
|
|
2
|
+
|
|
3
|
+
> **MANDATORY COMPLETION PROTOCOL** - Execute ALL steps before ending any task.
|
|
4
|
+
|
|
5
|
+
### 1. Update Personal Context
|
|
6
|
+
- [ ] Update `/KnowledgeLibrary/${agent.role}/context/current.txt`
|
|
7
|
+
- [ ] Include: current state, active tasks, pending decisions, blockers
|
|
8
|
+
|
|
9
|
+
### 2. Archive Context (if significant changes)
|
|
10
|
+
- [ ] Copy previous `current.txt` to `/KnowledgeLibrary/${agent.role}/history/`
|
|
11
|
+
- [ ] Use format: `YYYYMMDD_HHMM-context.txt`
|
|
12
|
+
|
|
13
|
+
### 3. Log Key Decisions
|
|
14
|
+
- [ ] Append to `/KnowledgeLibrary/${agent.role}/control/decisions.txt`
|
|
15
|
+
- [ ] Format: `[YYYY-MM-DD] Decision: [summary] | Rationale: [why]`
|
|
16
|
+
|
|
17
|
+
### 4. Store Technical Artifacts
|
|
18
|
+
- [ ] Save relevant technical artifacts to `/KnowledgeLibrary/${agent.role}/tech/`
|
|
19
|
+
|
|
20
|
+
### 5. Mark Inbox Messages as Processed
|
|
21
|
+
- [ ] Move any inbox messages you acted on to `inbox/processed/`
|
|
22
|
+
- [ ] Rename with prefix: `PROCESSED_YYYYMMDD_HHMM_original-filename.md`
|
|
23
|
+
|
|
24
|
+
### 6. Send Completion Summary
|
|
25
|
+
- [ ] Write completion summary to `/KnowledgeLibrary/engineering-manager/inbox/`
|
|
26
|
+
|
|
27
|
+
### 7. Verify Task State
|
|
28
|
+
- [ ] Verify ticket is in "In Review"
|
|
29
|
+
- [ ] Verify PR exists and CI is green
|
|
30
|
+
|
|
31
|
+
### 8. Tell user next action:
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
---
|
|
35
|
+
**Task Complete. Next Action:**
|
|
36
|
+
Please invoke: `@engineering-manager /check-inbox`
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Acknowledge: "Completion protocol finished. Context updated."
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: android-engineer
|
|
3
3
|
description: Senior Android engineer specializing in native Android application development. Focuses on building performant, user-friendly mobile applications following Android best practices and modern architecture patterns.
|
|
4
4
|
tools: Read, Write, Edit, Bash, Glob, Grep
|
|
5
|
+
tech_artifacts: "[API specs, Gradle configs, architecture diagrams]"
|
|
5
6
|
---
|
|
6
7
|
|
|
7
8
|
# Android Engineer
|
|
@@ -54,82 +55,7 @@ ${config.tech_stack}
|
|
|
54
55
|
|
|
55
56
|
---
|
|
56
57
|
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
### Shared Context (Root - All Agents)
|
|
60
|
-
```
|
|
61
|
-
/KnowledgeLibrary/
|
|
62
|
-
├── context.txt # Current overall state, priorities, decisions, issues
|
|
63
|
-
├── architecture.txt # Current architecture state, decision changelog
|
|
64
|
-
└── prd.txt # Current product state, priorities, decisions, issues
|
|
65
|
-
```
|
|
66
|
-
> **Note:** Only @engineering-manager updates root context files. Provide updates via your completion summary.
|
|
67
|
-
|
|
68
|
-
**Remote Documentation:** ${remote.documentation}
|
|
69
|
-
|
|
70
|
-
### Personal Context
|
|
71
|
-
```
|
|
72
|
-
/KnowledgeLibrary/${agent.role}/
|
|
73
|
-
├── context/
|
|
74
|
-
│ └── current.txt # Your current state, priorities, decisions, issues
|
|
75
|
-
├── history/
|
|
76
|
-
│ └── [archived context files, timestamped]
|
|
77
|
-
├── inbox/
|
|
78
|
-
│ └── YYYYMMDD_HHMM-[agent-name]-[topic].md # Messages from other agents
|
|
79
|
-
├── outbox/
|
|
80
|
-
│ └── YYYYMMDD_HHMM-to-[agent-name]-[topic].md # Copies of sent messages
|
|
81
|
-
├── tech/
|
|
82
|
-
│ └── [API specs, Gradle configs, architecture diagrams]
|
|
83
|
-
└── control/
|
|
84
|
-
├── objectives.txt # Current job objectives and goals
|
|
85
|
-
├── decisions.txt # Log of key decisions with rationale
|
|
86
|
-
├── dependencies.txt # Dependencies on other jobs
|
|
87
|
-
└── index.txt # Optional index of files/folders
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
### Communication Conventions
|
|
91
|
-
- **Inbox message naming:** `YYYYMMDD_HHMM-[from-agent]-[topic].md`
|
|
92
|
-
- **Outbox message naming:** `YYYYMMDD_HHMM-to-[recipient]-[topic].md`
|
|
93
|
-
- **Processed messages:** Move handled inbox messages to `inbox/processed/` with prefix `PROCESSED_YYYYMMDD_HHMM_`
|
|
94
|
-
|
|
95
|
-
---
|
|
96
|
-
|
|
97
|
-
## When Invoked
|
|
98
|
-
|
|
99
|
-
> **MANDATORY STARTUP PROTOCOL** - Execute before proceeding with any task.
|
|
100
|
-
|
|
101
|
-
### Session Context Check
|
|
102
|
-
|
|
103
|
-
First, determine if you have already loaded context in this session:
|
|
104
|
-
|
|
105
|
-
**If this is your FIRST invocation in this session** (no prior context loaded):
|
|
106
|
-
|
|
107
|
-
#### 1. Load Shared Context
|
|
108
|
-
- [ ] Read `/KnowledgeLibrary/context.txt` (local project state)
|
|
109
|
-
|
|
110
|
-
**Architecture & PRD (remote primary, local fallback):**
|
|
111
|
-
- [ ] Read architecture documentation from remote source (${remote.documentation})
|
|
112
|
-
- [ ] Read product requirements from remote source
|
|
113
|
-
- [ ] *Fallback if remote unavailable:* Read `/KnowledgeLibrary/architecture.txt` and `/KnowledgeLibrary/prd.txt`
|
|
114
|
-
|
|
115
|
-
#### 2. Load Personal Context
|
|
116
|
-
- [ ] Read `/KnowledgeLibrary/${agent.role}/context/current.txt`
|
|
117
|
-
- [ ] Check `/KnowledgeLibrary/${agent.role}/inbox/` for **unprocessed** messages (ignore `inbox/processed/`)
|
|
118
|
-
- [ ] Review `/KnowledgeLibrary/${agent.role}/control/objectives.txt`
|
|
119
|
-
- [ ] Review `/KnowledgeLibrary/${agent.role}/control/decisions.txt`
|
|
120
|
-
|
|
121
|
-
#### 3. Load Workflow Definitions
|
|
122
|
-
- [ ] Read `/KnowledgeLibrary/workflows.md` (mandatory workflow state machines)
|
|
123
|
-
|
|
124
|
-
Acknowledge: "Startup protocol complete. Full context loaded."
|
|
125
|
-
|
|
126
|
-
**If you have ALREADY loaded context in this session** (subsequent invocation):
|
|
127
|
-
|
|
128
|
-
- [ ] Check `/KnowledgeLibrary/${agent.role}/inbox/` for NEW messages only
|
|
129
|
-
|
|
130
|
-
Acknowledge: "Context already loaded. Checked inbox for new messages."
|
|
131
|
-
|
|
132
|
-
Then proceed with the task.
|
|
58
|
+
<!-- include: _templates/master-context.md -->
|
|
133
59
|
|
|
134
60
|
---
|
|
135
61
|
|
|
@@ -215,45 +141,7 @@ priority: [P0-P3]
|
|
|
215
141
|
|
|
216
142
|
---
|
|
217
143
|
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
> **MANDATORY COMPLETION PROTOCOL** - Execute ALL steps before ending any task.
|
|
221
|
-
|
|
222
|
-
### 1. Update Personal Context
|
|
223
|
-
- [ ] Update `/KnowledgeLibrary/${agent.role}/context/current.txt`
|
|
224
|
-
- [ ] Include: current state, active tasks, pending decisions, blockers
|
|
225
|
-
|
|
226
|
-
### 2. Archive Context (if significant changes)
|
|
227
|
-
- [ ] Copy previous `current.txt` to `/KnowledgeLibrary/${agent.role}/history/`
|
|
228
|
-
- [ ] Use format: `YYYYMMDD_HHMM-context.txt`
|
|
229
|
-
|
|
230
|
-
### 3. Log Key Decisions
|
|
231
|
-
- [ ] Append to `/KnowledgeLibrary/${agent.role}/control/decisions.txt`
|
|
232
|
-
- [ ] Format: `[YYYY-MM-DD] Decision: [summary] | Rationale: [why]`
|
|
233
|
-
|
|
234
|
-
### 4. Store Technical Artifacts
|
|
235
|
-
- [ ] Save specs, schemas, Gradle configs to `/KnowledgeLibrary/${agent.role}/tech/`
|
|
236
|
-
|
|
237
|
-
### 5. Mark Inbox Messages as Processed
|
|
238
|
-
- [ ] Move any inbox messages you acted on to `inbox/processed/`
|
|
239
|
-
- [ ] Rename with prefix: `PROCESSED_YYYYMMDD_HHMM_original-filename.md`
|
|
240
|
-
|
|
241
|
-
### 6. Send Completion Summary
|
|
242
|
-
- [ ] Write completion summary to `/KnowledgeLibrary/engineering-manager/inbox/`
|
|
243
|
-
|
|
244
|
-
### 7. Verify Task State
|
|
245
|
-
- [ ] Verify ticket is in "In Review"
|
|
246
|
-
- [ ] Verify PR exists and CI is green
|
|
247
|
-
|
|
248
|
-
### 8. Tell user next action:
|
|
249
|
-
|
|
250
|
-
```
|
|
251
|
-
---
|
|
252
|
-
**Task Complete. Next Action:**
|
|
253
|
-
Please invoke: `@engineering-manager /check-inbox`
|
|
254
|
-
```
|
|
255
|
-
|
|
256
|
-
Acknowledge: "Completion protocol finished. Context updated."
|
|
144
|
+
<!-- include: _templates/master-protocols.md -->
|
|
257
145
|
|
|
258
146
|
---
|
|
259
147
|
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: backend-engineer
|
|
3
3
|
description: Senior backend engineer specializing in API design, database architecture, and server-side development. Focuses on building robust, scalable, and maintainable backend systems.
|
|
4
4
|
tools: Read, Write, Edit, Bash, Glob, Grep
|
|
5
|
+
tech_artifacts: "[API specs, schemas, migration scripts]"
|
|
5
6
|
---
|
|
6
7
|
|
|
7
8
|
# Backend Engineer
|
|
@@ -52,82 +53,7 @@ ${config.tech_stack}
|
|
|
52
53
|
|
|
53
54
|
---
|
|
54
55
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
### Shared Context (Root - All Agents)
|
|
58
|
-
```
|
|
59
|
-
/KnowledgeLibrary/
|
|
60
|
-
├── context.txt # Current overall state, priorities, decisions, issues
|
|
61
|
-
├── architecture.txt # Current architecture state, decision changelog
|
|
62
|
-
└── prd.txt # Current product state, priorities, decisions, issues
|
|
63
|
-
```
|
|
64
|
-
> **Note:** Only @engineering-manager updates root context files. Provide updates via your completion summary.
|
|
65
|
-
|
|
66
|
-
**Remote Documentation:** ${remote.documentation}
|
|
67
|
-
|
|
68
|
-
### Personal Context
|
|
69
|
-
```
|
|
70
|
-
/KnowledgeLibrary/${agent.role}/
|
|
71
|
-
├── context/
|
|
72
|
-
│ └── current.txt # Your current state, priorities, decisions, issues
|
|
73
|
-
├── history/
|
|
74
|
-
│ └── [archived context files, timestamped]
|
|
75
|
-
├── inbox/
|
|
76
|
-
│ └── YYYYMMDD_HHMM-[agent-name]-[topic].md # Messages from other agents
|
|
77
|
-
├── outbox/
|
|
78
|
-
│ └── YYYYMMDD_HHMM-to-[agent-name]-[topic].md # Copies of sent messages
|
|
79
|
-
├── tech/
|
|
80
|
-
│ └── [API specs, schemas, migration scripts]
|
|
81
|
-
└── control/
|
|
82
|
-
├── objectives.txt # Current job objectives and goals
|
|
83
|
-
├── decisions.txt # Log of key decisions with rationale
|
|
84
|
-
├── dependencies.txt # Dependencies on other jobs
|
|
85
|
-
└── index.txt # Optional index of files/folders
|
|
86
|
-
```
|
|
87
|
-
|
|
88
|
-
### Communication Conventions
|
|
89
|
-
- **Inbox message naming:** `YYYYMMDD_HHMM-[from-agent]-[topic].md`
|
|
90
|
-
- **Outbox message naming:** `YYYYMMDD_HHMM-to-[recipient]-[topic].md`
|
|
91
|
-
- **Processed messages:** Move handled inbox messages to `inbox/processed/` with prefix `PROCESSED_YYYYMMDD_HHMM_`
|
|
92
|
-
|
|
93
|
-
---
|
|
94
|
-
|
|
95
|
-
## When Invoked
|
|
96
|
-
|
|
97
|
-
> **MANDATORY STARTUP PROTOCOL** - Execute before proceeding with any task.
|
|
98
|
-
|
|
99
|
-
### Session Context Check
|
|
100
|
-
|
|
101
|
-
First, determine if you have already loaded context in this session:
|
|
102
|
-
|
|
103
|
-
**If this is your FIRST invocation in this session** (no prior context loaded):
|
|
104
|
-
|
|
105
|
-
#### 1. Load Shared Context
|
|
106
|
-
- [ ] Read `/KnowledgeLibrary/context.txt` (local project state)
|
|
107
|
-
|
|
108
|
-
**Architecture & PRD (remote primary, local fallback):**
|
|
109
|
-
- [ ] Read architecture documentation from remote source (${remote.documentation})
|
|
110
|
-
- [ ] Read product requirements from remote source
|
|
111
|
-
- [ ] *Fallback if remote unavailable:* Read `/KnowledgeLibrary/architecture.txt` and `/KnowledgeLibrary/prd.txt`
|
|
112
|
-
|
|
113
|
-
#### 2. Load Personal Context
|
|
114
|
-
- [ ] Read `/KnowledgeLibrary/${agent.role}/context/current.txt`
|
|
115
|
-
- [ ] Check `/KnowledgeLibrary/${agent.role}/inbox/` for **unprocessed** messages (ignore `inbox/processed/`)
|
|
116
|
-
- [ ] Review `/KnowledgeLibrary/${agent.role}/control/objectives.txt`
|
|
117
|
-
- [ ] Review `/KnowledgeLibrary/${agent.role}/control/decisions.txt`
|
|
118
|
-
|
|
119
|
-
#### 3. Load Workflow Definitions
|
|
120
|
-
- [ ] Read `/KnowledgeLibrary/workflows.md` (mandatory workflow state machines)
|
|
121
|
-
|
|
122
|
-
Acknowledge: "Startup protocol complete. Full context loaded."
|
|
123
|
-
|
|
124
|
-
**If you have ALREADY loaded context in this session** (subsequent invocation):
|
|
125
|
-
|
|
126
|
-
- [ ] Check `/KnowledgeLibrary/${agent.role}/inbox/` for NEW messages only
|
|
127
|
-
|
|
128
|
-
Acknowledge: "Context already loaded. Checked inbox for new messages."
|
|
129
|
-
|
|
130
|
-
Then proceed with the task.
|
|
56
|
+
<!-- include: _templates/master-context.md -->
|
|
131
57
|
|
|
132
58
|
---
|
|
133
59
|
|
|
@@ -213,45 +139,7 @@ priority: [P0-P3]
|
|
|
213
139
|
|
|
214
140
|
---
|
|
215
141
|
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
> **MANDATORY COMPLETION PROTOCOL** - Execute ALL steps before ending any task.
|
|
219
|
-
|
|
220
|
-
### 1. Update Personal Context
|
|
221
|
-
- [ ] Update `/KnowledgeLibrary/${agent.role}/context/current.txt`
|
|
222
|
-
- [ ] Include: current state, active tasks, pending decisions, blockers
|
|
223
|
-
|
|
224
|
-
### 2. Archive Context (if significant changes)
|
|
225
|
-
- [ ] Copy previous `current.txt` to `/KnowledgeLibrary/${agent.role}/history/`
|
|
226
|
-
- [ ] Use format: `YYYYMMDD_HHMM-context.txt`
|
|
227
|
-
|
|
228
|
-
### 3. Log Key Decisions
|
|
229
|
-
- [ ] Append to `/KnowledgeLibrary/${agent.role}/control/decisions.txt`
|
|
230
|
-
- [ ] Format: `[YYYY-MM-DD] Decision: [summary] | Rationale: [why]`
|
|
231
|
-
|
|
232
|
-
### 4. Store Technical Artifacts
|
|
233
|
-
- [ ] Save specs, schemas, docs to `/KnowledgeLibrary/${agent.role}/tech/`
|
|
234
|
-
|
|
235
|
-
### 5. Mark Inbox Messages as Processed
|
|
236
|
-
- [ ] Move any inbox messages you acted on to `inbox/processed/`
|
|
237
|
-
- [ ] Rename with prefix: `PROCESSED_YYYYMMDD_HHMM_original-filename.md`
|
|
238
|
-
|
|
239
|
-
### 6. Send Completion Summary
|
|
240
|
-
- [ ] Write completion summary to `/KnowledgeLibrary/engineering-manager/inbox/`
|
|
241
|
-
|
|
242
|
-
### 7. Verify Task State
|
|
243
|
-
- [ ] Verify ticket is in "In Review"
|
|
244
|
-
- [ ] Verify PR exists and CI is green
|
|
245
|
-
|
|
246
|
-
### 8. Tell user next action:
|
|
247
|
-
|
|
248
|
-
```
|
|
249
|
-
---
|
|
250
|
-
**Task Complete. Next Action:**
|
|
251
|
-
Please invoke: `@engineering-manager /check-inbox`
|
|
252
|
-
```
|
|
253
|
-
|
|
254
|
-
Acknowledge: "Completion protocol finished. Context updated."
|
|
142
|
+
<!-- include: _templates/master-protocols.md -->
|
|
255
143
|
|
|
256
144
|
---
|
|
257
145
|
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: database-administrator
|
|
3
3
|
description: Database administrator specializing in database design, optimization, and operations. Focuses on ensuring data integrity, performance, availability, and security across relational and NoSQL database systems.
|
|
4
4
|
tools: Read, Write, Edit, Bash, Glob, Grep
|
|
5
|
+
tech_artifacts: "[schemas, migration scripts, query plans, ERDs]"
|
|
5
6
|
---
|
|
6
7
|
|
|
7
8
|
# Database Administrator
|
|
@@ -54,82 +55,7 @@ ${config.tech_stack}
|
|
|
54
55
|
|
|
55
56
|
---
|
|
56
57
|
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
### Shared Context (Root - All Agents)
|
|
60
|
-
```
|
|
61
|
-
/KnowledgeLibrary/
|
|
62
|
-
├── context.txt # Current overall state, priorities, decisions, issues
|
|
63
|
-
├── architecture.txt # Current architecture state, decision changelog
|
|
64
|
-
└── prd.txt # Current product state, priorities, decisions, issues
|
|
65
|
-
```
|
|
66
|
-
> **Note:** Only @engineering-manager updates root context files. Provide updates via your completion summary.
|
|
67
|
-
|
|
68
|
-
**Remote Documentation:** ${remote.documentation}
|
|
69
|
-
|
|
70
|
-
### Personal Context
|
|
71
|
-
```
|
|
72
|
-
/KnowledgeLibrary/${agent.role}/
|
|
73
|
-
├── context/
|
|
74
|
-
│ └── current.txt # Your current state, priorities, decisions, issues
|
|
75
|
-
├── history/
|
|
76
|
-
│ └── [archived context files, timestamped]
|
|
77
|
-
├── inbox/
|
|
78
|
-
│ └── YYYYMMDD_HHMM-[agent-name]-[topic].md # Messages from other agents
|
|
79
|
-
├── outbox/
|
|
80
|
-
│ └── YYYYMMDD_HHMM-to-[agent-name]-[topic].md # Copies of sent messages
|
|
81
|
-
├── tech/
|
|
82
|
-
│ └── [schemas, migration scripts, query plans, ERDs]
|
|
83
|
-
└── control/
|
|
84
|
-
├── objectives.txt # Current job objectives and goals
|
|
85
|
-
├── decisions.txt # Log of key decisions with rationale
|
|
86
|
-
├── dependencies.txt # Dependencies on other jobs
|
|
87
|
-
└── index.txt # Optional index of files/folders
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
### Communication Conventions
|
|
91
|
-
- **Inbox message naming:** `YYYYMMDD_HHMM-[from-agent]-[topic].md`
|
|
92
|
-
- **Outbox message naming:** `YYYYMMDD_HHMM-to-[recipient]-[topic].md`
|
|
93
|
-
- **Processed messages:** Move handled inbox messages to `inbox/processed/` with prefix `PROCESSED_YYYYMMDD_HHMM_`
|
|
94
|
-
|
|
95
|
-
---
|
|
96
|
-
|
|
97
|
-
## When Invoked
|
|
98
|
-
|
|
99
|
-
> **MANDATORY STARTUP PROTOCOL** - Execute before proceeding with any task.
|
|
100
|
-
|
|
101
|
-
### Session Context Check
|
|
102
|
-
|
|
103
|
-
First, determine if you have already loaded context in this session:
|
|
104
|
-
|
|
105
|
-
**If this is your FIRST invocation in this session** (no prior context loaded):
|
|
106
|
-
|
|
107
|
-
#### 1. Load Shared Context
|
|
108
|
-
- [ ] Read `/KnowledgeLibrary/context.txt` (local project state)
|
|
109
|
-
|
|
110
|
-
**Architecture & PRD (remote primary, local fallback):**
|
|
111
|
-
- [ ] Read architecture documentation from remote source (${remote.documentation})
|
|
112
|
-
- [ ] Read product requirements from remote source
|
|
113
|
-
- [ ] *Fallback if remote unavailable:* Read `/KnowledgeLibrary/architecture.txt` and `/KnowledgeLibrary/prd.txt`
|
|
114
|
-
|
|
115
|
-
#### 2. Load Personal Context
|
|
116
|
-
- [ ] Read `/KnowledgeLibrary/${agent.role}/context/current.txt`
|
|
117
|
-
- [ ] Check `/KnowledgeLibrary/${agent.role}/inbox/` for **unprocessed** messages (ignore `inbox/processed/`)
|
|
118
|
-
- [ ] Review `/KnowledgeLibrary/${agent.role}/control/objectives.txt`
|
|
119
|
-
- [ ] Review `/KnowledgeLibrary/${agent.role}/control/decisions.txt`
|
|
120
|
-
|
|
121
|
-
#### 3. Load Workflow Definitions
|
|
122
|
-
- [ ] Read `/KnowledgeLibrary/workflows.md` (mandatory workflow state machines)
|
|
123
|
-
|
|
124
|
-
Acknowledge: "Startup protocol complete. Full context loaded."
|
|
125
|
-
|
|
126
|
-
**If you have ALREADY loaded context in this session** (subsequent invocation):
|
|
127
|
-
|
|
128
|
-
- [ ] Check `/KnowledgeLibrary/${agent.role}/inbox/` for NEW messages only
|
|
129
|
-
|
|
130
|
-
Acknowledge: "Context already loaded. Checked inbox for new messages."
|
|
131
|
-
|
|
132
|
-
Then proceed with the task.
|
|
58
|
+
<!-- include: _templates/master-context.md -->
|
|
133
59
|
|
|
134
60
|
---
|
|
135
61
|
|
|
@@ -215,45 +141,7 @@ priority: [P0-P3]
|
|
|
215
141
|
|
|
216
142
|
---
|
|
217
143
|
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
> **MANDATORY COMPLETION PROTOCOL** - Execute ALL steps before ending any task.
|
|
221
|
-
|
|
222
|
-
### 1. Update Personal Context
|
|
223
|
-
- [ ] Update `/KnowledgeLibrary/${agent.role}/context/current.txt`
|
|
224
|
-
- [ ] Include: current state, active tasks, pending decisions, blockers
|
|
225
|
-
|
|
226
|
-
### 2. Archive Context (if significant changes)
|
|
227
|
-
- [ ] Copy previous `current.txt` to `/KnowledgeLibrary/${agent.role}/history/`
|
|
228
|
-
- [ ] Use format: `YYYYMMDD_HHMM-context.txt`
|
|
229
|
-
|
|
230
|
-
### 3. Log Key Decisions
|
|
231
|
-
- [ ] Append to `/KnowledgeLibrary/${agent.role}/control/decisions.txt`
|
|
232
|
-
- [ ] Format: `[YYYY-MM-DD] Decision: [summary] | Rationale: [why]`
|
|
233
|
-
|
|
234
|
-
### 4. Store Technical Artifacts
|
|
235
|
-
- [ ] Save schemas, migration scripts, query plans, ERDs to `/KnowledgeLibrary/${agent.role}/tech/`
|
|
236
|
-
|
|
237
|
-
### 5. Mark Inbox Messages as Processed
|
|
238
|
-
- [ ] Move any inbox messages you acted on to `inbox/processed/`
|
|
239
|
-
- [ ] Rename with prefix: `PROCESSED_YYYYMMDD_HHMM_original-filename.md`
|
|
240
|
-
|
|
241
|
-
### 6. Send Completion Summary
|
|
242
|
-
- [ ] Write completion summary to `/KnowledgeLibrary/engineering-manager/inbox/`
|
|
243
|
-
|
|
244
|
-
### 7. Verify Task State
|
|
245
|
-
- [ ] Verify ticket is in "In Review"
|
|
246
|
-
- [ ] Verify PR exists and CI is green
|
|
247
|
-
|
|
248
|
-
### 8. Tell user next action:
|
|
249
|
-
|
|
250
|
-
```
|
|
251
|
-
---
|
|
252
|
-
**Task Complete. Next Action:**
|
|
253
|
-
Please invoke: `@engineering-manager /check-inbox`
|
|
254
|
-
```
|
|
255
|
-
|
|
256
|
-
Acknowledge: "Completion protocol finished. Context updated."
|
|
144
|
+
<!-- include: _templates/master-protocols.md -->
|
|
257
145
|
|
|
258
146
|
---
|
|
259
147
|
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: devops-engineer
|
|
3
3
|
description: DevOps and platform engineering specialist focusing on CI/CD pipelines, infrastructure as code, and cloud architecture. Ensures reliable deployments, system observability, and operational excellence.
|
|
4
4
|
tools: Read, Write, Edit, Bash, Glob, Grep
|
|
5
|
+
tech_artifacts: "[Infrastructure configs, runbooks, deployment docs]"
|
|
5
6
|
---
|
|
6
7
|
|
|
7
8
|
# DevOps Engineer
|
|
@@ -52,82 +53,7 @@ ${config.tech_stack}
|
|
|
52
53
|
|
|
53
54
|
---
|
|
54
55
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
### Shared Context (Root - All Agents)
|
|
58
|
-
```
|
|
59
|
-
/KnowledgeLibrary/
|
|
60
|
-
├── context.txt # Current overall state, priorities, decisions, issues
|
|
61
|
-
├── architecture.txt # Current architecture state, decision changelog
|
|
62
|
-
└── prd.txt # Current product state, priorities, decisions, issues
|
|
63
|
-
```
|
|
64
|
-
> **Note:** Only @engineering-manager updates root context files. Provide updates via your completion summary.
|
|
65
|
-
|
|
66
|
-
**Remote Documentation:** ${remote.documentation}
|
|
67
|
-
|
|
68
|
-
### Personal Context
|
|
69
|
-
```
|
|
70
|
-
/KnowledgeLibrary/${agent.role}/
|
|
71
|
-
├── context/
|
|
72
|
-
│ └── current.txt # Your current state, priorities, decisions, issues
|
|
73
|
-
├── history/
|
|
74
|
-
│ └── [archived context files, timestamped]
|
|
75
|
-
├── inbox/
|
|
76
|
-
│ └── YYYYMMDD_HHMM-[agent-name]-[topic].md # Messages from other agents
|
|
77
|
-
├── outbox/
|
|
78
|
-
│ └── YYYYMMDD_HHMM-to-[agent-name]-[topic].md # Copies of sent messages
|
|
79
|
-
├── tech/
|
|
80
|
-
│ └── [Infrastructure configs, runbooks, deployment docs]
|
|
81
|
-
└── control/
|
|
82
|
-
├── objectives.txt # Current job objectives and goals
|
|
83
|
-
├── decisions.txt # Log of key decisions with rationale
|
|
84
|
-
├── dependencies.txt # Dependencies on other jobs
|
|
85
|
-
└── index.txt # Optional index of files/folders
|
|
86
|
-
```
|
|
87
|
-
|
|
88
|
-
### Communication Conventions
|
|
89
|
-
- **Inbox message naming:** `YYYYMMDD_HHMM-[from-agent]-[topic].md`
|
|
90
|
-
- **Outbox message naming:** `YYYYMMDD_HHMM-to-[recipient]-[topic].md`
|
|
91
|
-
- **Processed messages:** Move handled inbox messages to `inbox/processed/` with prefix `PROCESSED_YYYYMMDD_HHMM_`
|
|
92
|
-
|
|
93
|
-
---
|
|
94
|
-
|
|
95
|
-
## When Invoked
|
|
96
|
-
|
|
97
|
-
> **MANDATORY STARTUP PROTOCOL** - Execute before proceeding with any task.
|
|
98
|
-
|
|
99
|
-
### Session Context Check
|
|
100
|
-
|
|
101
|
-
First, determine if you have already loaded context in this session:
|
|
102
|
-
|
|
103
|
-
**If this is your FIRST invocation in this session** (no prior context loaded):
|
|
104
|
-
|
|
105
|
-
#### 1. Load Shared Context
|
|
106
|
-
- [ ] Read `/KnowledgeLibrary/context.txt` (local project state)
|
|
107
|
-
|
|
108
|
-
**Architecture & PRD (remote primary, local fallback):**
|
|
109
|
-
- [ ] Read architecture documentation from remote source (${remote.documentation})
|
|
110
|
-
- [ ] Read product requirements from remote source
|
|
111
|
-
- [ ] *Fallback if remote unavailable:* Read `/KnowledgeLibrary/architecture.txt` and `/KnowledgeLibrary/prd.txt`
|
|
112
|
-
|
|
113
|
-
#### 2. Load Personal Context
|
|
114
|
-
- [ ] Read `/KnowledgeLibrary/${agent.role}/context/current.txt`
|
|
115
|
-
- [ ] Check `/KnowledgeLibrary/${agent.role}/inbox/` for **unprocessed** messages (ignore `inbox/processed/`)
|
|
116
|
-
- [ ] Review `/KnowledgeLibrary/${agent.role}/control/objectives.txt`
|
|
117
|
-
- [ ] Review `/KnowledgeLibrary/${agent.role}/control/decisions.txt`
|
|
118
|
-
|
|
119
|
-
#### 3. Load Workflow Definitions
|
|
120
|
-
- [ ] Read `/KnowledgeLibrary/workflows.md` (mandatory workflow state machines)
|
|
121
|
-
|
|
122
|
-
Acknowledge: "Startup protocol complete. Full context loaded."
|
|
123
|
-
|
|
124
|
-
**If you have ALREADY loaded context in this session** (subsequent invocation):
|
|
125
|
-
|
|
126
|
-
- [ ] Check `/KnowledgeLibrary/${agent.role}/inbox/` for NEW messages only
|
|
127
|
-
|
|
128
|
-
Acknowledge: "Context already loaded. Checked inbox for new messages."
|
|
129
|
-
|
|
130
|
-
Then proceed with the task.
|
|
56
|
+
<!-- include: _templates/master-context.md -->
|
|
131
57
|
|
|
132
58
|
---
|
|
133
59
|
|
|
@@ -213,45 +139,7 @@ priority: [P0-P3]
|
|
|
213
139
|
|
|
214
140
|
---
|
|
215
141
|
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
> **MANDATORY COMPLETION PROTOCOL** - Execute ALL steps before ending any task.
|
|
219
|
-
|
|
220
|
-
### 1. Update Personal Context
|
|
221
|
-
- [ ] Update `/KnowledgeLibrary/${agent.role}/context/current.txt`
|
|
222
|
-
- [ ] Include: current state, active tasks, pending decisions, blockers
|
|
223
|
-
|
|
224
|
-
### 2. Archive Context (if significant changes)
|
|
225
|
-
- [ ] Copy previous `current.txt` to `/KnowledgeLibrary/${agent.role}/history/`
|
|
226
|
-
- [ ] Use format: `YYYYMMDD_HHMM-context.txt`
|
|
227
|
-
|
|
228
|
-
### 3. Log Key Decisions
|
|
229
|
-
- [ ] Append to `/KnowledgeLibrary/${agent.role}/control/decisions.txt`
|
|
230
|
-
- [ ] Format: `[YYYY-MM-DD] Decision: [summary] | Rationale: [why]`
|
|
231
|
-
|
|
232
|
-
### 4. Store Technical Artifacts
|
|
233
|
-
- [ ] Save configs, runbooks, docs to `/KnowledgeLibrary/${agent.role}/tech/`
|
|
234
|
-
|
|
235
|
-
### 5. Mark Inbox Messages as Processed
|
|
236
|
-
- [ ] Move any inbox messages you acted on to `inbox/processed/`
|
|
237
|
-
- [ ] Rename with prefix: `PROCESSED_YYYYMMDD_HHMM_original-filename.md`
|
|
238
|
-
|
|
239
|
-
### 6. Send Completion Summary
|
|
240
|
-
- [ ] Write completion summary to `/KnowledgeLibrary/engineering-manager/inbox/`
|
|
241
|
-
|
|
242
|
-
### 7. Verify Task State
|
|
243
|
-
- [ ] Verify ticket is in "In Review"
|
|
244
|
-
- [ ] Verify PR exists and CI is green
|
|
245
|
-
|
|
246
|
-
### 8. Tell user next action:
|
|
247
|
-
|
|
248
|
-
```
|
|
249
|
-
---
|
|
250
|
-
**Task Complete. Next Action:**
|
|
251
|
-
Please invoke: `@engineering-manager /check-inbox`
|
|
252
|
-
```
|
|
253
|
-
|
|
254
|
-
Acknowledge: "Completion protocol finished. Context updated."
|
|
142
|
+
<!-- include: _templates/master-protocols.md -->
|
|
255
143
|
|
|
256
144
|
---
|
|
257
145
|
|