@enki-dev-expert/global-engineering-standards 0.0.0-stage → 0.1.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/AGENTS.md +303 -0
- package/CHANGELOG.md +23 -0
- package/CITATION.cff +21 -0
- package/CODE_OF_CONDUCT.md +13 -0
- package/CONTRIBUTING.md +27 -0
- package/LICENSE +21 -0
- package/README.md +159 -2
- package/SECURITY.md +25 -0
- package/dist/cli.js +40 -0
- package/dist/content.js +71 -0
- package/dist/filesystem.js +83 -0
- package/dist/installer.js +243 -0
- package/dist/layout.js +42 -0
- package/dist/transaction.js +143 -0
- package/docs/ai-and-llm.md +1312 -0
- package/docs/architecture.md +1007 -0
- package/docs/cost-engineering.md +1322 -0
- package/docs/data.md +993 -0
- package/docs/governance.md +1744 -0
- package/docs/mobile-and-web.md +1362 -0
- package/docs/observability.md +1345 -0
- package/docs/platforms-and-applications.md +1581 -0
- package/docs/privacy.md +566 -0
- package/docs/quality-and-testing.md +1278 -0
- package/docs/scalability.md +1012 -0
- package/docs/security.md +373 -0
- package/handbook/claude-plugin.md +31 -0
- package/handbook/compatibility.md +27 -0
- package/handbook/recovery.md +29 -0
- package/handbook/releasing.md +50 -0
- package/handbook/security-review.md +41 -0
- package/handbook/signing.md +18 -0
- package/handbook/validation.md +50 -0
- package/package.json +65 -4
- package/scripts/content-baseline.json +25 -0
- package/skills/engineering-architecture-review/SKILL.md +1531 -0
- package/skills/engineering-cost-estimate/SKILL.md +1599 -0
- package/skills/engineering-database-review/SKILL.md +1364 -0
- package/skills/engineering-privacy-check/SKILL.md +1295 -0
- package/skills/engineering-safe-implementation/SKILL.md +1502 -0
- package/skills/engineering-security-standards-check/SKILL.md +1112 -0
- package/src/cli.ts +45 -0
- package/src/content.ts +82 -0
- package/src/filesystem.ts +94 -0
- package/src/installer.ts +280 -0
- package/src/layout.ts +70 -0
- package/src/transaction.ts +167 -0
- package/templates/ADR.md +1302 -0
- package/templates/AUDIT_REPORT.md +1693 -0
- package/templates/EXCEPTIONS.md +647 -0
- package/templates/PROJECT_AGENTS.md +868 -0
|
@@ -0,0 +1,1502 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: engineering-safe-implementation
|
|
3
|
+
description: Plan, implement, test, debug and deliver software safely under the Global Engineering Standards. Use for end-to-end application development, autonomous builds, feature implementation, refactoring, bug fixing, integration work, regression prevention, quality validation, deployment preparation and final engineering handoff.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Engineering Safe Implementation
|
|
7
|
+
|
|
8
|
+
## 1. Purpose
|
|
9
|
+
|
|
10
|
+
Provide a repeatable, secure and quality-focused workflow for software implementation.
|
|
11
|
+
|
|
12
|
+
This skill supports:
|
|
13
|
+
|
|
14
|
+
- Complete application development.
|
|
15
|
+
- New feature implementation.
|
|
16
|
+
- Existing application maintenance.
|
|
17
|
+
- Bug fixing.
|
|
18
|
+
- Safe refactoring.
|
|
19
|
+
- API implementation.
|
|
20
|
+
- Database integration.
|
|
21
|
+
- AI and agentic functionality.
|
|
22
|
+
- Web and mobile development.
|
|
23
|
+
- Desktop and native development.
|
|
24
|
+
- Game development.
|
|
25
|
+
- Testing and validation.
|
|
26
|
+
- Error correction.
|
|
27
|
+
- Deployment preparation.
|
|
28
|
+
- Autonomous engineering execution.
|
|
29
|
+
- Final delivery and handoff.
|
|
30
|
+
|
|
31
|
+
The objective is to convert requirements into working, maintainable and appropriately validated software without compromising fundamental engineering safeguards.
|
|
32
|
+
|
|
33
|
+
Do not equate generated code with completed functionality.
|
|
34
|
+
|
|
35
|
+
## 2. Global Engineering Standards
|
|
36
|
+
|
|
37
|
+
The Global Engineering Standards repository is located at:
|
|
38
|
+
|
|
39
|
+
~/engineering-standards/
|
|
40
|
+
|
|
41
|
+
Primary entry point:
|
|
42
|
+
|
|
43
|
+
~/engineering-standards/AGENTS.md
|
|
44
|
+
|
|
45
|
+
Apply relevant standards from:
|
|
46
|
+
|
|
47
|
+
- docs/security.md
|
|
48
|
+
- docs/privacy.md
|
|
49
|
+
- docs/architecture.md
|
|
50
|
+
- docs/data.md
|
|
51
|
+
- docs/scalability.md
|
|
52
|
+
- docs/cost-engineering.md
|
|
53
|
+
- docs/ai-and-llm.md
|
|
54
|
+
- docs/quality-and-testing.md
|
|
55
|
+
- docs/observability.md
|
|
56
|
+
- docs/mobile-and-web.md
|
|
57
|
+
- docs/platforms-and-applications.md
|
|
58
|
+
- docs/governance.md
|
|
59
|
+
|
|
60
|
+
Resolve these paths relative to the engineering-standards repository.
|
|
61
|
+
|
|
62
|
+
Read applicable standards according to the actual task and technology.
|
|
63
|
+
|
|
64
|
+
Do not load every document unnecessarily.
|
|
65
|
+
|
|
66
|
+
## 3. Related Engineering Skills
|
|
67
|
+
|
|
68
|
+
Use relevant specialized procedures when appropriate:
|
|
69
|
+
|
|
70
|
+
- engineering-security-standards-check
|
|
71
|
+
- engineering-privacy-check
|
|
72
|
+
- engineering-database-review
|
|
73
|
+
- engineering-cost-estimate
|
|
74
|
+
- engineering-architecture-review
|
|
75
|
+
|
|
76
|
+
Do not assume every specialized skill must run for every trivial code change.
|
|
77
|
+
|
|
78
|
+
Select the procedures justified by project risk and scope.
|
|
79
|
+
|
|
80
|
+
Preserve the requirements of all applicable global standards.
|
|
81
|
+
|
|
82
|
+
## 4. When to Use This Skill
|
|
83
|
+
|
|
84
|
+
Use for:
|
|
85
|
+
|
|
86
|
+
- Building an application from scratch.
|
|
87
|
+
- Implementing a complete feature.
|
|
88
|
+
- Executing a development plan.
|
|
89
|
+
- Fixing a confirmed defect.
|
|
90
|
+
- Performing authorized refactoring.
|
|
91
|
+
- Adding or modifying APIs.
|
|
92
|
+
- Integrating databases.
|
|
93
|
+
- Implementing authentication.
|
|
94
|
+
- Building AI-powered functionality.
|
|
95
|
+
- Preparing an application for release.
|
|
96
|
+
- Validating completed implementation.
|
|
97
|
+
- Coordinating Autonomous Build Mode.
|
|
98
|
+
|
|
99
|
+
For a strictly read-only audit, use the relevant review skills and audit template without modifying the application.
|
|
100
|
+
|
|
101
|
+
## 5. Fundamental Implementation Principles
|
|
102
|
+
|
|
103
|
+
Apply:
|
|
104
|
+
|
|
105
|
+
1. Requirements before implementation.
|
|
106
|
+
2. Architecture appropriate to the problem.
|
|
107
|
+
3. Security by Design.
|
|
108
|
+
4. Privacy by Design.
|
|
109
|
+
5. Data integrity.
|
|
110
|
+
6. Clear component responsibilities.
|
|
111
|
+
7. Maintainable code.
|
|
112
|
+
8. Appropriate automated testing.
|
|
113
|
+
9. Regression prevention.
|
|
114
|
+
10. Cost awareness.
|
|
115
|
+
11. Reliable error handling.
|
|
116
|
+
12. Relevant observability.
|
|
117
|
+
13. Platform compatibility.
|
|
118
|
+
14. Honest verification.
|
|
119
|
+
15. Human approval for protected operations.
|
|
120
|
+
|
|
121
|
+
Prefer the simplest effective implementation.
|
|
122
|
+
|
|
123
|
+
Avoid unnecessary technologies, dependencies and abstractions.
|
|
124
|
+
|
|
125
|
+
## 6. Operating Modes
|
|
126
|
+
|
|
127
|
+
Support:
|
|
128
|
+
|
|
129
|
+
- Supervised Mode.
|
|
130
|
+
- Autonomous Build Mode.
|
|
131
|
+
|
|
132
|
+
Supervised Mode is the default.
|
|
133
|
+
|
|
134
|
+
Autonomous Build Mode requires an explicit user instruction authorizing end-to-end autonomous development.
|
|
135
|
+
|
|
136
|
+
The chosen mode changes approval frequency, not engineering quality.
|
|
137
|
+
|
|
138
|
+
Consult docs/governance.md.
|
|
139
|
+
|
|
140
|
+
Do not activate autonomous development merely because this skill is loaded.
|
|
141
|
+
|
|
142
|
+
## 7. Supervised Mode
|
|
143
|
+
|
|
144
|
+
For Supervised Mode:
|
|
145
|
+
|
|
146
|
+
1. Inspect relevant project files.
|
|
147
|
+
2. Understand the requested change.
|
|
148
|
+
3. Identify affected components.
|
|
149
|
+
4. Assess risks and dependencies.
|
|
150
|
+
5. Propose a suitable implementation approach.
|
|
151
|
+
6. Obtain approval before significant modifications.
|
|
152
|
+
7. Implement within the approved scope.
|
|
153
|
+
8. Run relevant validation.
|
|
154
|
+
9. Correct authorized defects.
|
|
155
|
+
10. Report actual results.
|
|
156
|
+
|
|
157
|
+
Existing production audits begin read-only.
|
|
158
|
+
|
|
159
|
+
Do not make unrelated changes.
|
|
160
|
+
|
|
161
|
+
## 8. Autonomous Build Mode
|
|
162
|
+
|
|
163
|
+
When the user explicitly requests autonomous application development:
|
|
164
|
+
|
|
165
|
+
1. Understand the complete objective.
|
|
166
|
+
2. Review available project context.
|
|
167
|
+
3. Identify relevant engineering standards.
|
|
168
|
+
4. Define architecture and implementation stages.
|
|
169
|
+
5. Implement all feasible authorized functionality.
|
|
170
|
+
6. Configure appropriate local tooling.
|
|
171
|
+
7. Add required tests.
|
|
172
|
+
8. Run available validation.
|
|
173
|
+
9. Investigate failures.
|
|
174
|
+
10. Correct defects within scope.
|
|
175
|
+
11. Continue with the next independent task.
|
|
176
|
+
12. Prepare documentation and deployment artifacts.
|
|
177
|
+
13. Record unresolved external dependencies.
|
|
178
|
+
14. Deliver a complete and honest handoff.
|
|
179
|
+
|
|
180
|
+
Do not request approval after every ordinary development milestone.
|
|
181
|
+
|
|
182
|
+
Do not ask the user to perform tasks the agent is authorized and technically able to complete.
|
|
183
|
+
|
|
184
|
+
Do not promise indefinite execution beyond the available environment or session.
|
|
185
|
+
|
|
186
|
+
## 9. Autonomous Authorization Scope
|
|
187
|
+
|
|
188
|
+
An explicit end-to-end build request may authorize ordinary development within the stated project scope.
|
|
189
|
+
|
|
190
|
+
Subject to actual tool permissions, this may include:
|
|
191
|
+
|
|
192
|
+
- Creating project files.
|
|
193
|
+
- Modifying authorized source files.
|
|
194
|
+
- Implementing features.
|
|
195
|
+
- Writing tests.
|
|
196
|
+
- Running local tests.
|
|
197
|
+
- Building local artifacts.
|
|
198
|
+
- Selecting suitable libraries.
|
|
199
|
+
- Installing appropriate project dependencies.
|
|
200
|
+
- Preparing migration files.
|
|
201
|
+
- Creating local test fixtures.
|
|
202
|
+
- Fixing build failures.
|
|
203
|
+
- Updating project documentation.
|
|
204
|
+
|
|
205
|
+
This authorization does not automatically include production deployments, destructive changes, paid commitments or privileged external actions.
|
|
206
|
+
|
|
207
|
+
## 10. No Unnecessary Interruptions
|
|
208
|
+
|
|
209
|
+
In Autonomous Build Mode:
|
|
210
|
+
|
|
211
|
+
- Do not stop after one implemented feature.
|
|
212
|
+
- Do not request approval for every source file.
|
|
213
|
+
- Do not ask repeatedly about requirements already established.
|
|
214
|
+
- Do not require confirmation for routine authorized tests.
|
|
215
|
+
- Do not pause after every architectural decision.
|
|
216
|
+
- Do not stop merely because errors are encountered.
|
|
217
|
+
- Do not delegate ordinary executable work back to the user unnecessarily.
|
|
218
|
+
|
|
219
|
+
Make reasonable, reversible technical decisions within scope.
|
|
220
|
+
|
|
221
|
+
Document material assumptions.
|
|
222
|
+
|
|
223
|
+
Continue independent work when another task is blocked.
|
|
224
|
+
|
|
225
|
+
## 11. Autonomous Build Quality Contract
|
|
226
|
+
|
|
227
|
+
Autonomous execution must preserve all applicable engineering requirements.
|
|
228
|
+
|
|
229
|
+
Mandatory considerations include:
|
|
230
|
+
|
|
231
|
+
- Security.
|
|
232
|
+
- Privacy.
|
|
233
|
+
- Authentication.
|
|
234
|
+
- Authorization.
|
|
235
|
+
- Data integrity.
|
|
236
|
+
- Architecture.
|
|
237
|
+
- Scalability.
|
|
238
|
+
- Reliability.
|
|
239
|
+
- Performance.
|
|
240
|
+
- Cost efficiency.
|
|
241
|
+
- Maintainability.
|
|
242
|
+
- Accessibility.
|
|
243
|
+
- Testing.
|
|
244
|
+
- Observability.
|
|
245
|
+
- Platform compatibility.
|
|
246
|
+
- Safe deployment preparation.
|
|
247
|
+
|
|
248
|
+
Do not downgrade security or testing merely to finish faster.
|
|
249
|
+
|
|
250
|
+
Do not claim compliance or large-scale readiness without evidence.
|
|
251
|
+
|
|
252
|
+
## 12. Project Identification
|
|
253
|
+
|
|
254
|
+
Before implementation, identify:
|
|
255
|
+
|
|
256
|
+
- Project name.
|
|
257
|
+
- Repository location.
|
|
258
|
+
- Project purpose.
|
|
259
|
+
- Target users.
|
|
260
|
+
- Supported platforms.
|
|
261
|
+
- Existing technology stack.
|
|
262
|
+
- Current development status.
|
|
263
|
+
- Relevant integrations.
|
|
264
|
+
- Operational environment.
|
|
265
|
+
- Authorized development scope.
|
|
266
|
+
|
|
267
|
+
For an existing project, inspect actual files before making assumptions.
|
|
268
|
+
|
|
269
|
+
Do not infer technologies from another application.
|
|
270
|
+
|
|
271
|
+
## 13. Requirements Analysis
|
|
272
|
+
|
|
273
|
+
Identify:
|
|
274
|
+
|
|
275
|
+
- Required features.
|
|
276
|
+
- Primary workflows.
|
|
277
|
+
- Business invariants.
|
|
278
|
+
- User roles.
|
|
279
|
+
- Data requirements.
|
|
280
|
+
- Security requirements.
|
|
281
|
+
- Privacy requirements.
|
|
282
|
+
- Integration requirements.
|
|
283
|
+
- Non-functional requirements.
|
|
284
|
+
- Acceptance criteria.
|
|
285
|
+
|
|
286
|
+
Separate known requirements from assumptions.
|
|
287
|
+
|
|
288
|
+
Do not invent essential product behavior.
|
|
289
|
+
|
|
290
|
+
## 14. Handling Missing Requirements
|
|
291
|
+
|
|
292
|
+
When a non-critical detail is unspecified:
|
|
293
|
+
|
|
294
|
+
- Choose a reasonable safe default.
|
|
295
|
+
- Prefer reversible decisions.
|
|
296
|
+
- Follow established project conventions.
|
|
297
|
+
- Document the assumption.
|
|
298
|
+
- Continue authorized work.
|
|
299
|
+
|
|
300
|
+
When a material business decision cannot be safely inferred:
|
|
301
|
+
|
|
302
|
+
- Identify the blocker.
|
|
303
|
+
- Avoid implementing an arbitrary irreversible choice.
|
|
304
|
+
- Continue independent work.
|
|
305
|
+
- Request clarification only when genuinely necessary.
|
|
306
|
+
|
|
307
|
+
Do not turn ordinary uncertainty into unnecessary approval requests.
|
|
308
|
+
|
|
309
|
+
## 15. Architecture-First Planning
|
|
310
|
+
|
|
311
|
+
Before substantial implementation, define:
|
|
312
|
+
|
|
313
|
+
- Main components.
|
|
314
|
+
- Responsibility boundaries.
|
|
315
|
+
- Data flows.
|
|
316
|
+
- Trust boundaries.
|
|
317
|
+
- Database approach.
|
|
318
|
+
- External integrations.
|
|
319
|
+
- Testing strategy.
|
|
320
|
+
- Deployment assumptions.
|
|
321
|
+
- Scaling path.
|
|
322
|
+
- Relevant costs.
|
|
323
|
+
|
|
324
|
+
Architecture-first planning does not require excessive documentation for trivial projects.
|
|
325
|
+
|
|
326
|
+
Consult docs/architecture.md.
|
|
327
|
+
|
|
328
|
+
## 16. Technology Stack Selection
|
|
329
|
+
|
|
330
|
+
For new projects, select technologies based on:
|
|
331
|
+
|
|
332
|
+
- Product requirements.
|
|
333
|
+
- Platform constraints.
|
|
334
|
+
- Security.
|
|
335
|
+
- Maintainability.
|
|
336
|
+
- Ecosystem maturity.
|
|
337
|
+
- Performance.
|
|
338
|
+
- Scalability.
|
|
339
|
+
- Operational complexity.
|
|
340
|
+
- Cost.
|
|
341
|
+
- Available expertise.
|
|
342
|
+
|
|
343
|
+
Do not impose a favorite framework or provider.
|
|
344
|
+
|
|
345
|
+
For existing projects, preserve suitable technology choices.
|
|
346
|
+
|
|
347
|
+
## 17. Project Structure
|
|
348
|
+
|
|
349
|
+
Organize source code with clear responsibilities.
|
|
350
|
+
|
|
351
|
+
Consider:
|
|
352
|
+
|
|
353
|
+
- Feature boundaries.
|
|
354
|
+
- Shared utilities.
|
|
355
|
+
- Domain logic.
|
|
356
|
+
- Infrastructure adapters.
|
|
357
|
+
- Configuration.
|
|
358
|
+
- Tests.
|
|
359
|
+
- Documentation.
|
|
360
|
+
- Static assets.
|
|
361
|
+
- Build tooling.
|
|
362
|
+
|
|
363
|
+
Avoid unnecessary folder depth.
|
|
364
|
+
|
|
365
|
+
Do not introduce abstractions without practical value.
|
|
366
|
+
|
|
367
|
+
## 18. Incremental Implementation
|
|
368
|
+
|
|
369
|
+
Prefer small, verifiable implementation stages.
|
|
370
|
+
|
|
371
|
+
For each stage:
|
|
372
|
+
|
|
373
|
+
1. Define intended behavior.
|
|
374
|
+
2. Implement relevant components.
|
|
375
|
+
3. Validate the change.
|
|
376
|
+
4. Correct observed failures.
|
|
377
|
+
5. Check related regressions.
|
|
378
|
+
6. Record important decisions.
|
|
379
|
+
7. Continue to the next stage.
|
|
380
|
+
|
|
381
|
+
In Autonomous Build Mode, these stages do not require repeated human approval when within authorized scope.
|
|
382
|
+
|
|
383
|
+
## 19. Existing Code Protection
|
|
384
|
+
|
|
385
|
+
Before modifying an existing project:
|
|
386
|
+
|
|
387
|
+
- Inspect relevant source code.
|
|
388
|
+
- Understand established conventions.
|
|
389
|
+
- Identify current behavior.
|
|
390
|
+
- Review related tests.
|
|
391
|
+
- Check repository status.
|
|
392
|
+
- Preserve unrelated user changes.
|
|
393
|
+
- Evaluate compatibility.
|
|
394
|
+
|
|
395
|
+
Do not replace working code merely because a different implementation is preferred.
|
|
396
|
+
|
|
397
|
+
## 20. Scope Control
|
|
398
|
+
|
|
399
|
+
Stay within the authorized repository and task.
|
|
400
|
+
|
|
401
|
+
Do not:
|
|
402
|
+
|
|
403
|
+
- Modify unrelated applications.
|
|
404
|
+
- Access unrelated private files.
|
|
405
|
+
- Change global developer settings unnecessarily.
|
|
406
|
+
- Replace unrelated configuration.
|
|
407
|
+
- Modify production systems without authorization.
|
|
408
|
+
- Expand project scope silently.
|
|
409
|
+
|
|
410
|
+
When scope is unclear, prefer the safest reasonable interpretation.
|
|
411
|
+
|
|
412
|
+
## 21. Secure Implementation
|
|
413
|
+
|
|
414
|
+
Apply relevant security controls from the beginning.
|
|
415
|
+
|
|
416
|
+
Consider:
|
|
417
|
+
|
|
418
|
+
- Secure defaults.
|
|
419
|
+
- Input validation.
|
|
420
|
+
- Authentication.
|
|
421
|
+
- Server-side authorization.
|
|
422
|
+
- Least privilege.
|
|
423
|
+
- Secret management.
|
|
424
|
+
- Safe dependencies.
|
|
425
|
+
- Secure error handling.
|
|
426
|
+
- Resource isolation.
|
|
427
|
+
- Supply chain integrity.
|
|
428
|
+
|
|
429
|
+
Do not add security only after the application is considered complete.
|
|
430
|
+
|
|
431
|
+
Consult docs/security.md.
|
|
432
|
+
|
|
433
|
+
## 22. Authentication Implementation
|
|
434
|
+
|
|
435
|
+
For authentication functionality:
|
|
436
|
+
|
|
437
|
+
- Use established authentication mechanisms.
|
|
438
|
+
- Validate identity at trusted boundaries.
|
|
439
|
+
- Handle session expiration.
|
|
440
|
+
- Protect tokens.
|
|
441
|
+
- Support appropriate recovery.
|
|
442
|
+
- Prevent unnecessary account enumeration.
|
|
443
|
+
- Restrict privileged operations.
|
|
444
|
+
|
|
445
|
+
Do not invent custom cryptographic authentication protocols.
|
|
446
|
+
|
|
447
|
+
## 23. Authorization Implementation
|
|
448
|
+
|
|
449
|
+
For authorization:
|
|
450
|
+
|
|
451
|
+
- Define user roles and permissions.
|
|
452
|
+
- Identify protected resources.
|
|
453
|
+
- Enforce resource ownership.
|
|
454
|
+
- Enforce tenant boundaries.
|
|
455
|
+
- Validate operations server-side.
|
|
456
|
+
- Apply least privilege.
|
|
457
|
+
- Test unauthorized access.
|
|
458
|
+
|
|
459
|
+
Do not trust client-provided roles or owner identifiers without appropriate verification.
|
|
460
|
+
|
|
461
|
+
Authentication does not replace authorization.
|
|
462
|
+
|
|
463
|
+
## 24. Privacy-Aware Implementation
|
|
464
|
+
|
|
465
|
+
Apply relevant:
|
|
466
|
+
|
|
467
|
+
- Data minimization.
|
|
468
|
+
- Privacy-protective defaults.
|
|
469
|
+
- Access restrictions.
|
|
470
|
+
- Retention requirements.
|
|
471
|
+
- Secure data handling.
|
|
472
|
+
- Sensitive logging controls.
|
|
473
|
+
- Third-party processing review.
|
|
474
|
+
- User rights support.
|
|
475
|
+
|
|
476
|
+
Do not invent legal bases or retention periods.
|
|
477
|
+
|
|
478
|
+
Consult docs/privacy.md.
|
|
479
|
+
|
|
480
|
+
## 25. Data Integrity Implementation
|
|
481
|
+
|
|
482
|
+
Protect important business invariants.
|
|
483
|
+
|
|
484
|
+
Consider:
|
|
485
|
+
|
|
486
|
+
- Database constraints.
|
|
487
|
+
- Transactions.
|
|
488
|
+
- Referential integrity.
|
|
489
|
+
- Atomic updates.
|
|
490
|
+
- Concurrency.
|
|
491
|
+
- Idempotency.
|
|
492
|
+
- Tenant isolation.
|
|
493
|
+
- Safe deletion.
|
|
494
|
+
|
|
495
|
+
Do not rely solely on client-side validation.
|
|
496
|
+
|
|
497
|
+
Consult docs/data.md.
|
|
498
|
+
|
|
499
|
+
## 26. Database Development
|
|
500
|
+
|
|
501
|
+
When databases are required:
|
|
502
|
+
|
|
503
|
+
1. Identify access patterns.
|
|
504
|
+
2. Choose an appropriate data model.
|
|
505
|
+
3. Define schema.
|
|
506
|
+
4. Add constraints.
|
|
507
|
+
5. Enforce authorization.
|
|
508
|
+
6. Plan migrations.
|
|
509
|
+
7. Add relevant tests.
|
|
510
|
+
8. Evaluate indexing.
|
|
511
|
+
9. Consider backups and recovery.
|
|
512
|
+
10. Document deployment requirements.
|
|
513
|
+
|
|
514
|
+
Do not execute destructive production migrations automatically.
|
|
515
|
+
|
|
516
|
+
## 27. API Implementation
|
|
517
|
+
|
|
518
|
+
For APIs:
|
|
519
|
+
|
|
520
|
+
- Validate requests.
|
|
521
|
+
- Enforce authentication where needed.
|
|
522
|
+
- Enforce resource authorization.
|
|
523
|
+
- Use appropriate error handling.
|
|
524
|
+
- Apply pagination and limits.
|
|
525
|
+
- Consider rate limiting.
|
|
526
|
+
- Implement idempotency where necessary.
|
|
527
|
+
- Protect secrets.
|
|
528
|
+
- Document relevant contracts.
|
|
529
|
+
|
|
530
|
+
Do not expose internal implementation details unnecessarily.
|
|
531
|
+
|
|
532
|
+
## 28. External Integrations
|
|
533
|
+
|
|
534
|
+
For third-party services:
|
|
535
|
+
|
|
536
|
+
- Define integration boundaries.
|
|
537
|
+
- Verify required permissions.
|
|
538
|
+
- Protect credentials.
|
|
539
|
+
- Handle timeouts.
|
|
540
|
+
- Implement bounded retries.
|
|
541
|
+
- Validate responses.
|
|
542
|
+
- Consider privacy implications.
|
|
543
|
+
- Evaluate costs.
|
|
544
|
+
- Document external dependencies.
|
|
545
|
+
|
|
546
|
+
Do not activate paid services without authorization.
|
|
547
|
+
|
|
548
|
+
## 29. Missing Credentials
|
|
549
|
+
|
|
550
|
+
When credentials are unavailable:
|
|
551
|
+
|
|
552
|
+
- Implement independent functionality.
|
|
553
|
+
- Prepare secure configuration templates.
|
|
554
|
+
- Use local mocks where appropriate.
|
|
555
|
+
- Validate failure handling.
|
|
556
|
+
- Document integration requirements.
|
|
557
|
+
- Continue other authorized tasks.
|
|
558
|
+
|
|
559
|
+
Never invent credentials.
|
|
560
|
+
|
|
561
|
+
Do not claim that a mocked integration was verified against the real service.
|
|
562
|
+
|
|
563
|
+
## 30. AI and LLM Implementation
|
|
564
|
+
|
|
565
|
+
When implementing AI functionality, evaluate:
|
|
566
|
+
|
|
567
|
+
- Actual need for AI.
|
|
568
|
+
- Model selection.
|
|
569
|
+
- Input handling.
|
|
570
|
+
- Output validation.
|
|
571
|
+
- Retrieval authorization.
|
|
572
|
+
- Sensitive data exposure.
|
|
573
|
+
- Prompt injection.
|
|
574
|
+
- Tool permissions.
|
|
575
|
+
- Evaluation.
|
|
576
|
+
- Inference costs.
|
|
577
|
+
- Human oversight.
|
|
578
|
+
|
|
579
|
+
Do not treat model output as trusted authorization.
|
|
580
|
+
|
|
581
|
+
Consult docs/ai-and-llm.md.
|
|
582
|
+
|
|
583
|
+
## 31. RAG Implementation
|
|
584
|
+
|
|
585
|
+
For RAG systems:
|
|
586
|
+
|
|
587
|
+
- Define document ingestion.
|
|
588
|
+
- Validate file processing.
|
|
589
|
+
- Establish chunking strategy.
|
|
590
|
+
- Protect embeddings.
|
|
591
|
+
- Apply access-controlled retrieval.
|
|
592
|
+
- Handle source metadata.
|
|
593
|
+
- Evaluate retrieval relevance.
|
|
594
|
+
- Limit unnecessary context.
|
|
595
|
+
- Validate generated responses.
|
|
596
|
+
- Support deletion where required.
|
|
597
|
+
|
|
598
|
+
A semantic match does not establish access authorization.
|
|
599
|
+
|
|
600
|
+
## 32. Agentic System Implementation
|
|
601
|
+
|
|
602
|
+
For application-level agents:
|
|
603
|
+
|
|
604
|
+
- Define agent responsibilities.
|
|
605
|
+
- Restrict tool permissions.
|
|
606
|
+
- Validate tool arguments.
|
|
607
|
+
- Apply execution limits.
|
|
608
|
+
- Control spending.
|
|
609
|
+
- Handle tool failures.
|
|
610
|
+
- Preserve auditability.
|
|
611
|
+
- Require approval for consequential actions.
|
|
612
|
+
- Test prompt injection resistance.
|
|
613
|
+
|
|
614
|
+
An application-level agent must not inherit unrestricted development permissions.
|
|
615
|
+
|
|
616
|
+
## 33. Web Development
|
|
617
|
+
|
|
618
|
+
For web applications, consider:
|
|
619
|
+
|
|
620
|
+
- Browser security.
|
|
621
|
+
- Responsive design.
|
|
622
|
+
- Accessibility.
|
|
623
|
+
- State management.
|
|
624
|
+
- API boundaries.
|
|
625
|
+
- Client-side error handling.
|
|
626
|
+
- Performance.
|
|
627
|
+
- Authentication flows.
|
|
628
|
+
- Secure storage.
|
|
629
|
+
- Cross-browser compatibility.
|
|
630
|
+
|
|
631
|
+
Consult docs/mobile-and-web.md.
|
|
632
|
+
|
|
633
|
+
## 34. Mobile Development
|
|
634
|
+
|
|
635
|
+
For iOS and Android, consider:
|
|
636
|
+
|
|
637
|
+
- Platform permissions.
|
|
638
|
+
- Secure local storage.
|
|
639
|
+
- Lifecycle management.
|
|
640
|
+
- Offline behavior.
|
|
641
|
+
- Synchronization.
|
|
642
|
+
- Network failures.
|
|
643
|
+
- Accessibility.
|
|
644
|
+
- Performance.
|
|
645
|
+
- Code signing.
|
|
646
|
+
- Release requirements.
|
|
647
|
+
|
|
648
|
+
Consult docs/mobile-and-web.md.
|
|
649
|
+
|
|
650
|
+
## 35. Desktop and Native Development
|
|
651
|
+
|
|
652
|
+
For desktop and native software, consider:
|
|
653
|
+
|
|
654
|
+
- Operating-system permissions.
|
|
655
|
+
- Filesystem access.
|
|
656
|
+
- Packaging.
|
|
657
|
+
- Signing.
|
|
658
|
+
- Update mechanisms.
|
|
659
|
+
- Local storage.
|
|
660
|
+
- Resource consumption.
|
|
661
|
+
- Platform compatibility.
|
|
662
|
+
- Native dependency safety.
|
|
663
|
+
|
|
664
|
+
Consult docs/platforms-and-applications.md.
|
|
665
|
+
|
|
666
|
+
## 36. Game Development
|
|
667
|
+
|
|
668
|
+
For games, consider:
|
|
669
|
+
|
|
670
|
+
- Engine constraints.
|
|
671
|
+
- Gameplay architecture.
|
|
672
|
+
- Asset management.
|
|
673
|
+
- Save data integrity.
|
|
674
|
+
- Multiplayer trust boundaries.
|
|
675
|
+
- Performance.
|
|
676
|
+
- Platform compatibility.
|
|
677
|
+
- Build pipelines.
|
|
678
|
+
- Distribution requirements.
|
|
679
|
+
|
|
680
|
+
Do not introduce multiplayer infrastructure when it is unnecessary.
|
|
681
|
+
|
|
682
|
+
Consult docs/platforms-and-applications.md.
|
|
683
|
+
|
|
684
|
+
## 37. Scalability Implementation
|
|
685
|
+
|
|
686
|
+
Design for actual expected demand and credible growth.
|
|
687
|
+
|
|
688
|
+
Consider:
|
|
689
|
+
|
|
690
|
+
- Component modularity.
|
|
691
|
+
- Stateless processing where appropriate.
|
|
692
|
+
- Database efficiency.
|
|
693
|
+
- Connection management.
|
|
694
|
+
- Queues.
|
|
695
|
+
- Caching.
|
|
696
|
+
- Resource limits.
|
|
697
|
+
- Monitoring.
|
|
698
|
+
- Capacity thresholds.
|
|
699
|
+
|
|
700
|
+
Do not prematurely provision infrastructure for millions of users.
|
|
701
|
+
|
|
702
|
+
Consult docs/scalability.md.
|
|
703
|
+
|
|
704
|
+
## 38. Performance Engineering
|
|
705
|
+
|
|
706
|
+
Identify relevant performance objectives.
|
|
707
|
+
|
|
708
|
+
Consider:
|
|
709
|
+
|
|
710
|
+
- Latency.
|
|
711
|
+
- Throughput.
|
|
712
|
+
- CPU utilization.
|
|
713
|
+
- Memory consumption.
|
|
714
|
+
- Database queries.
|
|
715
|
+
- Rendering.
|
|
716
|
+
- Network transfers.
|
|
717
|
+
- Background processing.
|
|
718
|
+
|
|
719
|
+
Optimize based on measurements or credible bottleneck evidence.
|
|
720
|
+
|
|
721
|
+
Do not sacrifice correctness for unsupported performance claims.
|
|
722
|
+
|
|
723
|
+
## 39. Cost-Aware Implementation
|
|
724
|
+
|
|
725
|
+
Evaluate:
|
|
726
|
+
|
|
727
|
+
- Dependency costs.
|
|
728
|
+
- Infrastructure usage.
|
|
729
|
+
- Database operations.
|
|
730
|
+
- Storage.
|
|
731
|
+
- Network traffic.
|
|
732
|
+
- Monitoring.
|
|
733
|
+
- AI inference.
|
|
734
|
+
- Background jobs.
|
|
735
|
+
|
|
736
|
+
Prefer suitable cost-efficient solutions.
|
|
737
|
+
|
|
738
|
+
Do not weaken security or reliability solely to reduce spending.
|
|
739
|
+
|
|
740
|
+
Consult docs/cost-engineering.md.
|
|
741
|
+
|
|
742
|
+
## 40. Dependency Management
|
|
743
|
+
|
|
744
|
+
Before adding dependencies:
|
|
745
|
+
|
|
746
|
+
- Confirm necessity.
|
|
747
|
+
- Review compatibility.
|
|
748
|
+
- Consider maintenance.
|
|
749
|
+
- Review license requirements.
|
|
750
|
+
- Assess security.
|
|
751
|
+
- Consider operational impact.
|
|
752
|
+
- Evaluate cost.
|
|
753
|
+
|
|
754
|
+
Avoid unnecessary packages.
|
|
755
|
+
|
|
756
|
+
Do not install untrusted privileged system software automatically.
|
|
757
|
+
|
|
758
|
+
## 41. Local Development Environment
|
|
759
|
+
|
|
760
|
+
Within authorized boundaries, agents may prepare:
|
|
761
|
+
|
|
762
|
+
- Project configuration.
|
|
763
|
+
- Local dependencies.
|
|
764
|
+
- Local databases.
|
|
765
|
+
- Test fixtures.
|
|
766
|
+
- Development scripts.
|
|
767
|
+
- Build configuration.
|
|
768
|
+
- Environment templates.
|
|
769
|
+
|
|
770
|
+
Do not overwrite real credentials.
|
|
771
|
+
|
|
772
|
+
Do not modify unrelated global settings without authorization.
|
|
773
|
+
|
|
774
|
+
## 42. Error Handling
|
|
775
|
+
|
|
776
|
+
Implement appropriate:
|
|
777
|
+
|
|
778
|
+
- Input error responses.
|
|
779
|
+
- Failure boundaries.
|
|
780
|
+
- Timeouts.
|
|
781
|
+
- Retry policies.
|
|
782
|
+
- Logging.
|
|
783
|
+
- User-facing feedback.
|
|
784
|
+
- Partial failure handling.
|
|
785
|
+
- Recovery behavior.
|
|
786
|
+
|
|
787
|
+
Do not swallow critical errors silently.
|
|
788
|
+
|
|
789
|
+
Avoid exposing secrets through error messages.
|
|
790
|
+
|
|
791
|
+
## 43. Reliability Engineering
|
|
792
|
+
|
|
793
|
+
Consider:
|
|
794
|
+
|
|
795
|
+
- Dependency failures.
|
|
796
|
+
- Graceful degradation.
|
|
797
|
+
- Idempotency.
|
|
798
|
+
- Recovery.
|
|
799
|
+
- Availability.
|
|
800
|
+
- Data consistency.
|
|
801
|
+
- Circuit breaking where justified.
|
|
802
|
+
- Operational observability.
|
|
803
|
+
|
|
804
|
+
Do not add distributed reliability mechanisms without actual need.
|
|
805
|
+
|
|
806
|
+
## 44. Accessibility and Usability
|
|
807
|
+
|
|
808
|
+
Where applicable:
|
|
809
|
+
|
|
810
|
+
- Use clear navigation.
|
|
811
|
+
- Provide understandable feedback.
|
|
812
|
+
- Support keyboard interaction.
|
|
813
|
+
- Respect accessibility semantics.
|
|
814
|
+
- Handle errors clearly.
|
|
815
|
+
- Avoid unnecessary workflow complexity.
|
|
816
|
+
- Support relevant assistive technologies.
|
|
817
|
+
|
|
818
|
+
Accessibility and usability are part of engineering quality.
|
|
819
|
+
|
|
820
|
+
Do not treat visual polish as a substitute for functional usability.
|
|
821
|
+
|
|
822
|
+
## 45. User Interface Preservation
|
|
823
|
+
|
|
824
|
+
For existing applications:
|
|
825
|
+
|
|
826
|
+
- Respect approved design systems.
|
|
827
|
+
- Preserve established functionality.
|
|
828
|
+
- Avoid unexpected visual redesigns.
|
|
829
|
+
- Maintain responsive behavior.
|
|
830
|
+
- Test important user journeys.
|
|
831
|
+
|
|
832
|
+
Only redesign interfaces within authorized scope.
|
|
833
|
+
|
|
834
|
+
## 46. Testing Strategy
|
|
835
|
+
|
|
836
|
+
Select tests according to:
|
|
837
|
+
|
|
838
|
+
- Business risk.
|
|
839
|
+
- Functional complexity.
|
|
840
|
+
- Data sensitivity.
|
|
841
|
+
- Security requirements.
|
|
842
|
+
- Integration boundaries.
|
|
843
|
+
- Platform behavior.
|
|
844
|
+
- Regression risk.
|
|
845
|
+
|
|
846
|
+
Possible tests include:
|
|
847
|
+
|
|
848
|
+
- Unit tests.
|
|
849
|
+
- Integration tests.
|
|
850
|
+
- End-to-end tests.
|
|
851
|
+
- Contract tests.
|
|
852
|
+
- Authorization tests.
|
|
853
|
+
- Database tests.
|
|
854
|
+
- Performance tests.
|
|
855
|
+
- Security tests.
|
|
856
|
+
|
|
857
|
+
Consult docs/quality-and-testing.md.
|
|
858
|
+
|
|
859
|
+
## 47. Test Implementation
|
|
860
|
+
|
|
861
|
+
For important functionality:
|
|
862
|
+
|
|
863
|
+
1. Define expected behavior.
|
|
864
|
+
2. Implement relevant tests.
|
|
865
|
+
3. Use safe fixtures.
|
|
866
|
+
4. Cover meaningful edge cases.
|
|
867
|
+
5. Test failure paths.
|
|
868
|
+
6. Validate authorization.
|
|
869
|
+
7. Verify important business invariants.
|
|
870
|
+
8. Avoid dependence on production data.
|
|
871
|
+
|
|
872
|
+
Do not write superficial tests merely to increase test counts.
|
|
873
|
+
|
|
874
|
+
## 48. Test Execution
|
|
875
|
+
|
|
876
|
+
Run relevant authorized tests when the environment allows.
|
|
877
|
+
|
|
878
|
+
Before execution:
|
|
879
|
+
|
|
880
|
+
- Verify commands.
|
|
881
|
+
- Identify required environment variables.
|
|
882
|
+
- Confirm target environment.
|
|
883
|
+
- Protect credentials.
|
|
884
|
+
- Evaluate side effects.
|
|
885
|
+
|
|
886
|
+
Do not run destructive tests against production.
|
|
887
|
+
|
|
888
|
+
Report exactly which tests were executed.
|
|
889
|
+
|
|
890
|
+
## 49. Failure Investigation
|
|
891
|
+
|
|
892
|
+
When tests or builds fail:
|
|
893
|
+
|
|
894
|
+
1. Read the actual error.
|
|
895
|
+
2. Identify the likely root cause.
|
|
896
|
+
3. Inspect related code.
|
|
897
|
+
4. Apply a focused correction.
|
|
898
|
+
5. Re-run the relevant check.
|
|
899
|
+
6. Review possible regressions.
|
|
900
|
+
7. Record unresolved problems.
|
|
901
|
+
|
|
902
|
+
Do not remove failing tests merely to produce a passing build.
|
|
903
|
+
|
|
904
|
+
## 50. Autonomous Error Correction
|
|
905
|
+
|
|
906
|
+
In Autonomous Build Mode:
|
|
907
|
+
|
|
908
|
+
- Correct routine implementation defects.
|
|
909
|
+
- Fix type errors.
|
|
910
|
+
- Fix lint failures.
|
|
911
|
+
- Repair broken imports.
|
|
912
|
+
- Resolve authorized dependency conflicts.
|
|
913
|
+
- Correct failed tests.
|
|
914
|
+
- Improve error handling.
|
|
915
|
+
- Revalidate modified functionality.
|
|
916
|
+
|
|
917
|
+
Continue safely while feasible.
|
|
918
|
+
|
|
919
|
+
Use bounded retries.
|
|
920
|
+
|
|
921
|
+
Do not create endless correction loops.
|
|
922
|
+
|
|
923
|
+
## 51. Regression Prevention
|
|
924
|
+
|
|
925
|
+
Before concluding a change:
|
|
926
|
+
|
|
927
|
+
- Identify affected workflows.
|
|
928
|
+
- Review related dependencies.
|
|
929
|
+
- Execute relevant tests.
|
|
930
|
+
- Preserve public interfaces where required.
|
|
931
|
+
- Verify important business behavior.
|
|
932
|
+
- Review unintended modifications.
|
|
933
|
+
|
|
934
|
+
Do not assume a localized change cannot cause wider regressions.
|
|
935
|
+
|
|
936
|
+
## 52. Build Validation
|
|
937
|
+
|
|
938
|
+
When applicable:
|
|
939
|
+
|
|
940
|
+
- Run a production-oriented build locally.
|
|
941
|
+
- Check type compilation.
|
|
942
|
+
- Review warnings.
|
|
943
|
+
- Verify generated artifacts.
|
|
944
|
+
- Check environment configuration.
|
|
945
|
+
- Validate supported target platforms.
|
|
946
|
+
|
|
947
|
+
A successful build does not prove the application is fully functional or production-ready.
|
|
948
|
+
|
|
949
|
+
## 53. Security Verification
|
|
950
|
+
|
|
951
|
+
For significant features, verify relevant:
|
|
952
|
+
|
|
953
|
+
- Authentication.
|
|
954
|
+
- Authorization.
|
|
955
|
+
- Input validation.
|
|
956
|
+
- Resource ownership.
|
|
957
|
+
- Tenant isolation.
|
|
958
|
+
- Secret handling.
|
|
959
|
+
- Unsafe dependencies.
|
|
960
|
+
- Common attack surfaces.
|
|
961
|
+
|
|
962
|
+
Do not claim vulnerability-free software.
|
|
963
|
+
|
|
964
|
+
Use the security review skill when appropriate.
|
|
965
|
+
|
|
966
|
+
## 54. Privacy Verification
|
|
967
|
+
|
|
968
|
+
For personal data functionality, verify relevant:
|
|
969
|
+
|
|
970
|
+
- Data minimization.
|
|
971
|
+
- Access restrictions.
|
|
972
|
+
- Logging.
|
|
973
|
+
- Retention.
|
|
974
|
+
- Export behavior.
|
|
975
|
+
- Deletion behavior.
|
|
976
|
+
- Third-party sharing.
|
|
977
|
+
- AI data handling.
|
|
978
|
+
|
|
979
|
+
Do not claim legal compliance based solely on automated checks.
|
|
980
|
+
|
|
981
|
+
## 55. Data Integrity Verification
|
|
982
|
+
|
|
983
|
+
For database-dependent functionality, verify:
|
|
984
|
+
|
|
985
|
+
- Constraints.
|
|
986
|
+
- Transactions.
|
|
987
|
+
- Concurrency behavior.
|
|
988
|
+
- Idempotency.
|
|
989
|
+
- Ownership.
|
|
990
|
+
- Tenant isolation.
|
|
991
|
+
- Migration compatibility.
|
|
992
|
+
- Recovery implications.
|
|
993
|
+
|
|
994
|
+
Do not treat passing unit tests as proof that production data is protected under every condition.
|
|
995
|
+
|
|
996
|
+
## 56. Performance Validation
|
|
997
|
+
|
|
998
|
+
When performance matters:
|
|
999
|
+
|
|
1000
|
+
- Identify relevant metrics.
|
|
1001
|
+
- Define representative workloads.
|
|
1002
|
+
- Use appropriate test environments.
|
|
1003
|
+
- Run permitted measurements.
|
|
1004
|
+
- Record actual results.
|
|
1005
|
+
- Compare results with targets.
|
|
1006
|
+
|
|
1007
|
+
Do not perform disruptive load tests against production without authorization.
|
|
1008
|
+
|
|
1009
|
+
Do not claim support for millions of users without adequate evidence.
|
|
1010
|
+
|
|
1011
|
+
## 57. Observability Implementation
|
|
1012
|
+
|
|
1013
|
+
For important functionality, consider:
|
|
1014
|
+
|
|
1015
|
+
- Structured logs.
|
|
1016
|
+
- Useful metrics.
|
|
1017
|
+
- Error reporting.
|
|
1018
|
+
- Request tracing.
|
|
1019
|
+
- Operational alerts.
|
|
1020
|
+
- Data privacy.
|
|
1021
|
+
- Retention.
|
|
1022
|
+
- Monitoring costs.
|
|
1023
|
+
|
|
1024
|
+
Avoid excessive logging and sensitive information exposure.
|
|
1025
|
+
|
|
1026
|
+
Consult docs/observability.md.
|
|
1027
|
+
|
|
1028
|
+
## 58. Review of Changes
|
|
1029
|
+
|
|
1030
|
+
Before finalizing:
|
|
1031
|
+
|
|
1032
|
+
1. Inspect the working tree.
|
|
1033
|
+
2. Review changed files.
|
|
1034
|
+
3. Identify unrelated modifications.
|
|
1035
|
+
4. Check for accidental secrets.
|
|
1036
|
+
5. Review generated artifacts.
|
|
1037
|
+
6. Confirm expected behavior.
|
|
1038
|
+
7. Record tests executed.
|
|
1039
|
+
8. Document limitations.
|
|
1040
|
+
|
|
1041
|
+
Never discard unrelated user changes.
|
|
1042
|
+
|
|
1043
|
+
## 59. Git Safety
|
|
1044
|
+
|
|
1045
|
+
Respect project version control conventions.
|
|
1046
|
+
|
|
1047
|
+
Do not:
|
|
1048
|
+
|
|
1049
|
+
- Force-push shared branches without authorization.
|
|
1050
|
+
- Delete unrelated untracked files.
|
|
1051
|
+
- Rewrite protected history.
|
|
1052
|
+
- Commit private credentials.
|
|
1053
|
+
- Publish code without authorization.
|
|
1054
|
+
- Run destructive cleanup without approval.
|
|
1055
|
+
|
|
1056
|
+
Create focused changes.
|
|
1057
|
+
|
|
1058
|
+
Use meaningful commit messages when commits are authorized.
|
|
1059
|
+
|
|
1060
|
+
## 60. CI/CD and Automation
|
|
1061
|
+
|
|
1062
|
+
When appropriate, implement:
|
|
1063
|
+
|
|
1064
|
+
- Build checks.
|
|
1065
|
+
- Formatting checks.
|
|
1066
|
+
- Type checking.
|
|
1067
|
+
- Unit tests.
|
|
1068
|
+
- Integration tests.
|
|
1069
|
+
- Security scans.
|
|
1070
|
+
- Dependency validation.
|
|
1071
|
+
- Deployment preparation.
|
|
1072
|
+
|
|
1073
|
+
Do not disable quality gates silently.
|
|
1074
|
+
|
|
1075
|
+
Do not interpret CI/CD configuration as permission to deploy to production.
|
|
1076
|
+
|
|
1077
|
+
## 61. Deployment Preparation
|
|
1078
|
+
|
|
1079
|
+
When deployment is part of the requested work:
|
|
1080
|
+
|
|
1081
|
+
- Prepare build artifacts.
|
|
1082
|
+
- Document required environment configuration.
|
|
1083
|
+
- Define deployment procedure.
|
|
1084
|
+
- Review security requirements.
|
|
1085
|
+
- Assess data migration needs.
|
|
1086
|
+
- Estimate relevant costs.
|
|
1087
|
+
- Define monitoring expectations.
|
|
1088
|
+
- Consider rollback.
|
|
1089
|
+
- Identify required approvals.
|
|
1090
|
+
|
|
1091
|
+
Do not deploy to production without explicit authorization.
|
|
1092
|
+
|
|
1093
|
+
## 62. Protected Operations
|
|
1094
|
+
|
|
1095
|
+
Require appropriate specific authorization before:
|
|
1096
|
+
|
|
1097
|
+
- Production deployments.
|
|
1098
|
+
- Destructive production migrations.
|
|
1099
|
+
- Deleting important data.
|
|
1100
|
+
- Privileged security changes.
|
|
1101
|
+
- Production access control modifications.
|
|
1102
|
+
- Significant paid commitments.
|
|
1103
|
+
- Subscription upgrades.
|
|
1104
|
+
- Publishing applications.
|
|
1105
|
+
- Modifying unrelated repositories.
|
|
1106
|
+
- Sending sensitive external communications.
|
|
1107
|
+
|
|
1108
|
+
Autonomous Build Mode does not override these boundaries.
|
|
1109
|
+
|
|
1110
|
+
## 63. Risk Classification
|
|
1111
|
+
|
|
1112
|
+
Evaluate significant changes according to:
|
|
1113
|
+
|
|
1114
|
+
- Security impact.
|
|
1115
|
+
- Privacy impact.
|
|
1116
|
+
- Data integrity.
|
|
1117
|
+
- Availability.
|
|
1118
|
+
- Financial exposure.
|
|
1119
|
+
- Compatibility.
|
|
1120
|
+
- Reversibility.
|
|
1121
|
+
- Operational consequences.
|
|
1122
|
+
|
|
1123
|
+
Escalate actions whose risk exceeds the approved scope.
|
|
1124
|
+
|
|
1125
|
+
Do not equate a small code diff with low risk.
|
|
1126
|
+
|
|
1127
|
+
## 64. Approval Interpretation
|
|
1128
|
+
|
|
1129
|
+
In Autonomous Build Mode, the user's explicit authorization for the project counts as approval for ordinary local development within that scope.
|
|
1130
|
+
|
|
1131
|
+
Do not require separate approval for every routine file change, implementation stage or local test.
|
|
1132
|
+
|
|
1133
|
+
This authorization does not cover protected operations or material changes outside scope.
|
|
1134
|
+
|
|
1135
|
+
Do not assume silence constitutes approval for additional privileged actions.
|
|
1136
|
+
|
|
1137
|
+
Consult docs/governance.md.
|
|
1138
|
+
|
|
1139
|
+
## 65. Working With Blockers
|
|
1140
|
+
|
|
1141
|
+
When a blocker occurs:
|
|
1142
|
+
|
|
1143
|
+
1. Identify the cause.
|
|
1144
|
+
2. Determine whether it is within scope.
|
|
1145
|
+
3. Attempt safe authorized resolution.
|
|
1146
|
+
4. Consider reasonable alternatives.
|
|
1147
|
+
5. Continue independent tasks.
|
|
1148
|
+
6. Record unresolved work.
|
|
1149
|
+
7. Escalate only when necessary.
|
|
1150
|
+
|
|
1151
|
+
Avoid repeatedly asking for the same missing information.
|
|
1152
|
+
|
|
1153
|
+
Do not conceal blockers to claim completion.
|
|
1154
|
+
|
|
1155
|
+
## 66. Missing External Services
|
|
1156
|
+
|
|
1157
|
+
If an external integration cannot be completed:
|
|
1158
|
+
|
|
1159
|
+
- Prepare the adapter or integration boundary.
|
|
1160
|
+
- Define configuration requirements.
|
|
1161
|
+
- Add safe mocks where appropriate.
|
|
1162
|
+
- Test independent functionality.
|
|
1163
|
+
- Document missing credentials.
|
|
1164
|
+
- Explain external dependencies.
|
|
1165
|
+
- Continue remaining authorized development.
|
|
1166
|
+
|
|
1167
|
+
Do not fabricate live integration verification.
|
|
1168
|
+
|
|
1169
|
+
## 67. Missing Platform Capabilities
|
|
1170
|
+
|
|
1171
|
+
If the execution environment cannot perform a required task:
|
|
1172
|
+
|
|
1173
|
+
- Identify the limitation.
|
|
1174
|
+
- Complete feasible independent work.
|
|
1175
|
+
- Prepare instructions for the blocked action.
|
|
1176
|
+
- Preserve implementation state.
|
|
1177
|
+
- Document necessary human steps.
|
|
1178
|
+
|
|
1179
|
+
Do not claim an unavailable capability was used successfully.
|
|
1180
|
+
|
|
1181
|
+
## 68. Autonomous Task Continuation
|
|
1182
|
+
|
|
1183
|
+
During an autonomous build:
|
|
1184
|
+
|
|
1185
|
+
- Maintain a record of completed tasks.
|
|
1186
|
+
- Track pending work.
|
|
1187
|
+
- Reassess blockers.
|
|
1188
|
+
- Continue with executable tasks.
|
|
1189
|
+
- Avoid unnecessary repeated planning.
|
|
1190
|
+
- Preserve relevant implementation context.
|
|
1191
|
+
|
|
1192
|
+
Do not promise persistent background execution unless an actual supported mechanism is configured.
|
|
1193
|
+
|
|
1194
|
+
## 69. Autonomous Completion Criteria
|
|
1195
|
+
|
|
1196
|
+
Before declaring an autonomous build complete, evaluate:
|
|
1197
|
+
|
|
1198
|
+
- Required features implemented.
|
|
1199
|
+
- Important workflows functional.
|
|
1200
|
+
- Appropriate security controls.
|
|
1201
|
+
- Appropriate privacy controls.
|
|
1202
|
+
- Data integrity safeguards.
|
|
1203
|
+
- Relevant testing.
|
|
1204
|
+
- Build validation.
|
|
1205
|
+
- Documented architecture.
|
|
1206
|
+
- Deployment preparation.
|
|
1207
|
+
- Known limitations.
|
|
1208
|
+
- External dependencies.
|
|
1209
|
+
- Required human actions.
|
|
1210
|
+
|
|
1211
|
+
Do not claim the application is fully complete if essential functionality is missing.
|
|
1212
|
+
|
|
1213
|
+
## 70. Honest Completion Status
|
|
1214
|
+
|
|
1215
|
+
Use clear statuses:
|
|
1216
|
+
|
|
1217
|
+
- Completed and validated.
|
|
1218
|
+
- Implemented but not fully verified.
|
|
1219
|
+
- Partially implemented.
|
|
1220
|
+
- Blocked by external dependency.
|
|
1221
|
+
- Awaiting human authorization.
|
|
1222
|
+
- Not implemented.
|
|
1223
|
+
|
|
1224
|
+
Distinguish local completion from production availability.
|
|
1225
|
+
|
|
1226
|
+
Do not present prototypes as validated production systems.
|
|
1227
|
+
|
|
1228
|
+
## 71. Final Handoff
|
|
1229
|
+
|
|
1230
|
+
At the end of significant implementation, provide:
|
|
1231
|
+
|
|
1232
|
+
1. Project summary.
|
|
1233
|
+
2. Features implemented.
|
|
1234
|
+
3. Architecture and technologies.
|
|
1235
|
+
4. Important source files.
|
|
1236
|
+
5. Data architecture.
|
|
1237
|
+
6. Security and privacy controls.
|
|
1238
|
+
7. Scalability and cost considerations.
|
|
1239
|
+
8. Tests executed.
|
|
1240
|
+
9. Test results.
|
|
1241
|
+
10. Build results.
|
|
1242
|
+
11. Known limitations.
|
|
1243
|
+
12. Unresolved blockers.
|
|
1244
|
+
13. Deployment status.
|
|
1245
|
+
14. Required human actions.
|
|
1246
|
+
15. Recommended next steps.
|
|
1247
|
+
|
|
1248
|
+
Clearly distinguish verified outcomes from assumptions.
|
|
1249
|
+
|
|
1250
|
+
## 72. Human Action Checklist
|
|
1251
|
+
|
|
1252
|
+
For Autonomous Build Mode, consolidate the remaining human actions.
|
|
1253
|
+
|
|
1254
|
+
Possible examples:
|
|
1255
|
+
|
|
1256
|
+
- Create external provider accounts.
|
|
1257
|
+
- Configure API credentials securely.
|
|
1258
|
+
- Approve paid service plans.
|
|
1259
|
+
- Configure domains.
|
|
1260
|
+
- Review legal terms.
|
|
1261
|
+
- Approve production migrations.
|
|
1262
|
+
- Approve deployment.
|
|
1263
|
+
- Configure application store accounts.
|
|
1264
|
+
- Perform restricted platform actions.
|
|
1265
|
+
|
|
1266
|
+
Include only actions actually needed for the project.
|
|
1267
|
+
|
|
1268
|
+
Do not invent mandatory dependencies.
|
|
1269
|
+
|
|
1270
|
+
## 73. Architecture Decision Records
|
|
1271
|
+
|
|
1272
|
+
For significant technical decisions, use:
|
|
1273
|
+
|
|
1274
|
+
~/engineering-standards/templates/ADR.md
|
|
1275
|
+
|
|
1276
|
+
Record:
|
|
1277
|
+
|
|
1278
|
+
- Context.
|
|
1279
|
+
- Options.
|
|
1280
|
+
- Decision.
|
|
1281
|
+
- Rationale.
|
|
1282
|
+
- Risks.
|
|
1283
|
+
- Cost implications.
|
|
1284
|
+
- Approval status.
|
|
1285
|
+
|
|
1286
|
+
An ADR does not grant permission for protected operations.
|
|
1287
|
+
|
|
1288
|
+
## 74. Standards Exceptions
|
|
1289
|
+
|
|
1290
|
+
When a requirement cannot reasonably be satisfied:
|
|
1291
|
+
|
|
1292
|
+
- Identify the limitation.
|
|
1293
|
+
- Evaluate compliant alternatives.
|
|
1294
|
+
- Assess risk.
|
|
1295
|
+
- Prepare an exception request.
|
|
1296
|
+
- Identify compensating controls.
|
|
1297
|
+
- Obtain appropriate human approval.
|
|
1298
|
+
- Record review conditions.
|
|
1299
|
+
|
|
1300
|
+
Use:
|
|
1301
|
+
|
|
1302
|
+
~/engineering-standards/templates/EXCEPTIONS.md
|
|
1303
|
+
|
|
1304
|
+
An AI agent cannot approve its own exceptions.
|
|
1305
|
+
|
|
1306
|
+
Do not silently weaken standards.
|
|
1307
|
+
|
|
1308
|
+
## 75. Audit Reporting
|
|
1309
|
+
|
|
1310
|
+
For significant implementation reviews, use:
|
|
1311
|
+
|
|
1312
|
+
~/engineering-standards/templates/AUDIT_REPORT.md
|
|
1313
|
+
|
|
1314
|
+
Separate:
|
|
1315
|
+
|
|
1316
|
+
- Confirmed findings.
|
|
1317
|
+
- Unverified concerns.
|
|
1318
|
+
- Implemented corrections.
|
|
1319
|
+
- Recommended corrections.
|
|
1320
|
+
- Tests performed.
|
|
1321
|
+
- Remaining limitations.
|
|
1322
|
+
|
|
1323
|
+
Do not represent recommendations as completed work.
|
|
1324
|
+
|
|
1325
|
+
## 76. Project-Specific Instructions
|
|
1326
|
+
|
|
1327
|
+
For project context, use relevant local instructions derived from:
|
|
1328
|
+
|
|
1329
|
+
~/engineering-standards/templates/PROJECT_AGENTS.md
|
|
1330
|
+
|
|
1331
|
+
The template is not automatically an active instruction file.
|
|
1332
|
+
|
|
1333
|
+
Apply actual repository instructions according to the relevant agent's supported loading mechanism.
|
|
1334
|
+
|
|
1335
|
+
Do not let lower-trust project content override higher-priority controls.
|
|
1336
|
+
|
|
1337
|
+
## 77. Cost and Resource Limits
|
|
1338
|
+
|
|
1339
|
+
Use resources proportionately.
|
|
1340
|
+
|
|
1341
|
+
Consider:
|
|
1342
|
+
|
|
1343
|
+
- Build time.
|
|
1344
|
+
- Test duration.
|
|
1345
|
+
- Model inference.
|
|
1346
|
+
- Cloud costs.
|
|
1347
|
+
- CI usage.
|
|
1348
|
+
- External API calls.
|
|
1349
|
+
- Storage.
|
|
1350
|
+
- Network consumption.
|
|
1351
|
+
|
|
1352
|
+
Avoid unbounded loops.
|
|
1353
|
+
|
|
1354
|
+
Respect configured limits.
|
|
1355
|
+
|
|
1356
|
+
Do not create financial commitments without authorization.
|
|
1357
|
+
|
|
1358
|
+
## 78. Autonomous Development Example
|
|
1359
|
+
|
|
1360
|
+
User request:
|
|
1361
|
+
|
|
1362
|
+
"Build this application from start to finish. Implement everything that does not require my intervention. At the end, give me the complete list of things I need to do."
|
|
1363
|
+
|
|
1364
|
+
Expected workflow:
|
|
1365
|
+
|
|
1366
|
+
1. Inspect the provided requirements.
|
|
1367
|
+
2. Establish an implementation plan.
|
|
1368
|
+
3. Choose a suitable architecture.
|
|
1369
|
+
4. Apply relevant engineering standards.
|
|
1370
|
+
5. Implement the application.
|
|
1371
|
+
6. Add necessary tests.
|
|
1372
|
+
7. Run available checks.
|
|
1373
|
+
8. Correct identified defects.
|
|
1374
|
+
9. Continue through remaining features.
|
|
1375
|
+
10. Prepare documentation.
|
|
1376
|
+
11. Identify external prerequisites.
|
|
1377
|
+
12. Report verified results.
|
|
1378
|
+
13. Present the consolidated human action checklist.
|
|
1379
|
+
|
|
1380
|
+
Do not interrupt at every ordinary development stage.
|
|
1381
|
+
|
|
1382
|
+
Do not perform unauthorized protected operations.
|
|
1383
|
+
|
|
1384
|
+
## 79. New Application Workflow
|
|
1385
|
+
|
|
1386
|
+
For a new application:
|
|
1387
|
+
|
|
1388
|
+
1. Identify requirements.
|
|
1389
|
+
2. Select technologies.
|
|
1390
|
+
3. Establish project structure.
|
|
1391
|
+
4. Define security and privacy boundaries.
|
|
1392
|
+
5. Design data architecture.
|
|
1393
|
+
6. Implement functional modules.
|
|
1394
|
+
7. Integrate authorized services.
|
|
1395
|
+
8. Add tests.
|
|
1396
|
+
9. Validate important workflows.
|
|
1397
|
+
10. Prepare build and deployment documentation.
|
|
1398
|
+
11. Report readiness and limitations.
|
|
1399
|
+
|
|
1400
|
+
Choose an appropriate level of architecture and infrastructure complexity.
|
|
1401
|
+
|
|
1402
|
+
## 80. Existing Application Workflow
|
|
1403
|
+
|
|
1404
|
+
For an existing application:
|
|
1405
|
+
|
|
1406
|
+
1. Inspect the current implementation.
|
|
1407
|
+
2. Identify relevant dependencies.
|
|
1408
|
+
3. Review current behavior.
|
|
1409
|
+
4. Protect existing data.
|
|
1410
|
+
5. Understand established conventions.
|
|
1411
|
+
6. Identify actual problems.
|
|
1412
|
+
7. Define focused changes.
|
|
1413
|
+
8. Obtain appropriate authorization.
|
|
1414
|
+
9. Implement within scope.
|
|
1415
|
+
10. Run regression checks.
|
|
1416
|
+
11. Document results.
|
|
1417
|
+
|
|
1418
|
+
When explicitly authorized for autonomous development, ordinary in-scope local changes may proceed under the initial authorization.
|
|
1419
|
+
|
|
1420
|
+
Existing production audits remain read-only unless implementation is separately authorized.
|
|
1421
|
+
|
|
1422
|
+
## 81. Multi-Agent Implementation
|
|
1423
|
+
|
|
1424
|
+
When multiple agents collaborate:
|
|
1425
|
+
|
|
1426
|
+
- Define task ownership.
|
|
1427
|
+
- Avoid conflicting edits.
|
|
1428
|
+
- Respect project boundaries.
|
|
1429
|
+
- Share necessary context.
|
|
1430
|
+
- Validate outputs.
|
|
1431
|
+
- Preserve security controls.
|
|
1432
|
+
- Coordinate integration.
|
|
1433
|
+
- Monitor resource use.
|
|
1434
|
+
|
|
1435
|
+
Do not delegate protected operations to bypass approvals.
|
|
1436
|
+
|
|
1437
|
+
## 82. Documentation Accuracy
|
|
1438
|
+
|
|
1439
|
+
Documentation should reflect the real application.
|
|
1440
|
+
|
|
1441
|
+
Do not invent:
|
|
1442
|
+
|
|
1443
|
+
- Completed features.
|
|
1444
|
+
- Successful integrations.
|
|
1445
|
+
- Passing tests.
|
|
1446
|
+
- Production deployment.
|
|
1447
|
+
- Security certification.
|
|
1448
|
+
- Regulatory approval.
|
|
1449
|
+
- Verified performance.
|
|
1450
|
+
|
|
1451
|
+
Keep README and implementation documentation aligned with actual behavior.
|
|
1452
|
+
|
|
1453
|
+
## 83. Definition of Done
|
|
1454
|
+
|
|
1455
|
+
For significant software implementation:
|
|
1456
|
+
|
|
1457
|
+
- Requirements understood.
|
|
1458
|
+
- Scope authorized.
|
|
1459
|
+
- Architecture appropriate.
|
|
1460
|
+
- Security reviewed.
|
|
1461
|
+
- Privacy considered.
|
|
1462
|
+
- Data integrity protected.
|
|
1463
|
+
- Maintainability considered.
|
|
1464
|
+
- Scalability evaluated.
|
|
1465
|
+
- Cost implications assessed.
|
|
1466
|
+
- Relevant tests implemented.
|
|
1467
|
+
- Tests executed where feasible.
|
|
1468
|
+
- Build verified where feasible.
|
|
1469
|
+
- Important regressions checked.
|
|
1470
|
+
- Documentation updated.
|
|
1471
|
+
- Protected actions approved.
|
|
1472
|
+
- Remaining issues recorded.
|
|
1473
|
+
- Final handoff prepared.
|
|
1474
|
+
|
|
1475
|
+
Do not claim completion when critical acceptance criteria remain unmet.
|
|
1476
|
+
|
|
1477
|
+
## 84. Final Safe Implementation Principles
|
|
1478
|
+
|
|
1479
|
+
Build according to real requirements.
|
|
1480
|
+
Use appropriate architecture.
|
|
1481
|
+
Apply Security by Design.
|
|
1482
|
+
Apply Privacy by Design.
|
|
1483
|
+
Preserve data integrity.
|
|
1484
|
+
Enforce authentication and authorization.
|
|
1485
|
+
Write maintainable code.
|
|
1486
|
+
Avoid unnecessary dependencies.
|
|
1487
|
+
Design credible scalability paths.
|
|
1488
|
+
Control infrastructure and AI costs.
|
|
1489
|
+
Test meaningful functionality.
|
|
1490
|
+
Investigate and correct errors.
|
|
1491
|
+
Prevent regressions.
|
|
1492
|
+
Protect existing user changes.
|
|
1493
|
+
Protect production environments.
|
|
1494
|
+
Respect tool and platform permissions.
|
|
1495
|
+
Never bypass protected approvals.
|
|
1496
|
+
Support authorized autonomous execution.
|
|
1497
|
+
Avoid unnecessary interruptions.
|
|
1498
|
+
Continue feasible independent work.
|
|
1499
|
+
Never fabricate test or deployment results.
|
|
1500
|
+
Distinguish implemented from verified.
|
|
1501
|
+
Report blockers and limitations honestly.
|
|
1502
|
+
Provide a complete human action checklist.
|