@deimoscloud/coreai 0.1.16 → 0.1.17

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.
@@ -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
- ## Knowledge Library Structure
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
- ## Before Finishing
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
- ## Knowledge Library Structure
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
- ## Before Finishing
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
- ## Knowledge Library Structure
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
- ## Before Finishing
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
- ## Knowledge Library Structure
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
- ## Before Finishing
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