code-principles/engineering-context.example.yaml at main · PeterRamotowski/code-principles · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
specification_version: 0.10.0
selection_mode: automatic-with-visible-result
project:
  artifact_type:
    value: fullstack-application
    confidence: explicit
    evidence:
    - repository owner classification
  secondary_artifact_types:
  - value: backend-service
    confidence: observed
    evidence:
    - server route handlers
  project_stage:
    value: active-product
    confidence: explicit
    evidence:
    - repository owner classification
  exposure:
  - value: organization-internal
    confidence: explicit
    evidence:
    - internal application
  - value: public-api
    confidence: explicit
    evidence:
    - documented external API consumers
  domain_complexity:
    value: moderate
    confidence: explicit
    evidence:
    - business workflows contain several cross-entity invariants
  architecture_authority:
    value: incremental-improvement
    confidence: explicit
    evidence:
    - bounded refactoring is allowed during feature work
  state_model:
  - value: transactional
    confidence: observed
    evidence:
    - relational database transactions
constraints:
  security:
    value: high
    confidence: explicit
    evidence:
    - authentication, authorization, and payment data
  reliability:
    value: elevated
    confidence: explicit
    evidence:
    - production service objective
  backward_compatibility:
    value: high
    confidence: explicit
    evidence:
    - external API consumers
  latency_sensitivity:
    value: elevated
    confidence: explicit
    evidence:
    - interactive application response budget
  throughput_sensitivity:
    value: normal
    confidence: explicit
    evidence: []
  memory_sensitivity:
    value: normal
    confidence: explicit
    evidence: []
  determinism:
    value: normal
    confidence: explicit
    evidence: []
  accessibility:
    value: elevated
    confidence: explicit
    evidence:
    - user interface accessibility requirement
runtime:
- value: browser
  confidence: observed
  evidence:
  - client components
- value: nodejs
  confidence: observed
  evidence:
  - server runtime configuration
languages:
- value: typescript
  version: 5.x
  confidence: observed
  evidence:
  - tsconfig.json
frameworks:
- value: react
  confidence: observed
  evidence:
  - react dependency
- value: nextjs
  confidence: observed
  evidence:
  - next dependency
  - next.config.ts
technologies:
- value: postgresql
  confidence: observed
  evidence:
  - database configuration
profiles:
  base: fullstack-web-application
  modifiers:
  - public-api
  - security-sensitive
overrides:
  skill_modes:
    abstraction-and-reuse: conservative
  required_patterns:
  - authoritative server-side validation for external input
  - idempotent processing for retried webhook operations
  prohibited_patterns:
  - microservices without explicit architecture approval
  - full CQRS without demonstrated need
  notes:
  - Preserve existing feature-oriented module boundaries.