semantics

This commit is contained in:
2026-05-20 09:59:03 +03:00
parent 82c1b92a51
commit d48e6c0d83
33 changed files with 2144 additions and 156 deletions

View File

@@ -201,8 +201,10 @@ tags:
C:
type: string
multiline: false
description: 'Алиас для COMPLEXITY. @C: 3 ≡ @COMPLEXITY: 3.'
description: 'DEPRECATED. Канонический формат сложности — [C:N] в заголовке #region. @C больше не использовать.'
alias_for: COMPLEXITY
deprecated: true
deprecated_since: '2026-05-19'
contract_types:
- Module
- Function
@@ -211,13 +213,13 @@ tags:
- Block
- Skill
- Agent
protected: false
protected: true
orthogonal: false
decision_memory: false
COMPLEXITY:
type: string
multiline: false
description: 'Уровень сложности (1-5). Универсально опциональный.'
description: 'Уровень сложности (1-5). Канонический формат — [C:N] в заголовке анкора #region. @COMPLEXITY как тэг допускается для обратной совместимости, но [C:N] предпочтителен.'
enum: ['1','2','3','4','5']
contract_types:
- Module
@@ -227,7 +229,7 @@ tags:
- Block
- Skill
- Agent
protected: false
protected: true
orthogonal: false
decision_memory: false
BRIEF:
@@ -439,7 +441,7 @@ tags:
multiline: false
description: 'Графовая зависимость. Обязателен с C3.'
is_reference: true
allowed_predicates: [DEPENDS_ON, CALLS, INHERITS, IMPLEMENTS, DISPATCHES, BINDS_TO, CALLED_BY, VERIFIES]
allowed_predicates: [DEPENDS_ON, CALLS, INHERITS, IMPLEMENTS, DISPATCHES, BINDS_TO, CALLED_BY, VERIFIES, USES]
contract_types:
- Module
- Function
@@ -478,10 +480,23 @@ tags:
protected: false
orthogonal: false
decision_memory: false
PUBLIC_API:
type: string
multiline: false
description: 'Публичный API контракта: какие классы/функции являются точками входа. Универсально опциональный.'
contract_types:
- Module
- Function
- Class
- Component
- Block
protected: false
orthogonal: true
decision_memory: false
RATIONALE:
type: string
multiline: true
description: 'Обоснование. Универсально опциональный (C1+). Decision Memory.'
description: 'Обоснование архитектурного решения. Универсально опциональный (C1+). Decision Memory. Хлебные крошки для следующего разработчика — объясни ПОЧЕМУ сделан этот выбор.'
contract_types:
- Module
- Function
@@ -497,7 +512,7 @@ tags:
REJECTED:
type: string
multiline: true
description: 'Отвергнутый путь. Универсально опциональный (C1+). Decision Memory.'
description: 'Отвергнутая альтернатива и причина отказа. Универсально опциональный (C1+). Decision Memory. Предотвращает повторение ошибок — задокументируй ЧТО пробовали и ПОЧЕМУ не сработало.'
contract_types:
- Module
- Function
@@ -541,8 +556,8 @@ tags:
LAYER:
type: string
multiline: false
description: 'Слой: Core, Domain, API, UI, Service, Infrastructure, Plugin. Универсально опциональный.'
enum: [Core, Domain, API, UI, Service, Infrastructure, Plugin]
description: 'Слой: Core, Domain, API, UI, Service, Infrastructure, Plugin, Tests. Универсально опциональный.'
enum: [Core, Domain, API, UI, Service, Infrastructure, Plugin, Tests]
contract_types:
- Module
- Skill