docs(governance): clarify regex patterns are code documentation

Add note to Phase 3 findings that regex patterns in code blocks are PATTERN
DEFINITIONS (technical documentation), not prohibited language usage.

Prevents confusion when inst_017 detection (correctly) identifies pattern
keywords in documentation.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
TheFlow 2025-10-28 13:03:32 +13:00
parent 808a4b9820
commit 059babebfc

View file

@ -152,12 +152,14 @@ democracy: {
}
```
**Proposed**:
**Proposed** (NOTE: Code below is PATTERN DEFINITION, not prohibited language usage):
```javascript
democracy: {
patterns: [
/(?:requires?|needs?|must\s+have|ensures?|guarantees?)\s+\w+\s+democrac(?:y|tic)/gi, // Prescriptive
/\bdemocratic\s+(?:governance|oversight|control)\s+(?:is|ensures|provides)/gi // Prescriptive structure
// Detects prescriptive framing (requires/needs/must/ensures/guarantees + democracy)
/(?:requires?|needs?|must\s+have|ensures?|guarantees?)\s+\w+\s+democrac(?:y|tic)/gi,
// Detects prescriptive structure (democratic + governance/oversight/control + is/ensures/provides)
/\bdemocratic\s+(?:governance|oversight|control)\s+(?:is|ensures|provides)/gi
],
concern: 'Prescriptive democratic framing may have political connotations in autocratic contexts',
suggestion: 'Consider "participatory governance", "stakeholder input", or "inclusive decision-making"',