Skip to content

feat: add AI-native development standard and align STYLE_GUIDE#10

Merged
marcusburghardt merged 2 commits into
complytime:mainfrom
marcusburghardt:standardize-ai-native-development
May 12, 2026
Merged

feat: add AI-native development standard and align STYLE_GUIDE#10
marcusburghardt merged 2 commits into
complytime:mainfrom
marcusburghardt:standardize-ai-native-development

Conversation

@marcusburghardt

Copy link
Copy Markdown
Member

Summary

  • Create AI_NATIVE_DEVELOPMENT.md as the org-wide single source of truth for AI-native development
  • Update STYLE_GUIDE.md to align with constitution v1.2.0

AI_NATIVE_DEVELOPMENT.md

New document covering:

  • AI-native development philosophy (spec-driven, convention-pack-enforced, council-reviewed)
  • 5-step workflow: specify -> spec review -> implement -> code review -> merge
  • File classification table (committed vs local-only)
  • Convention pack system and hierarchy
  • Disclosure standards (Assisted-by trailer requirement)
  • Agent-agnostic principle
  • Continuous improvement loop
  • Quick reference tables for contributors and maintainers

STYLE_GUIDE.md Alignment

Updated to match constitution v1.2.0:

  • Normalize to RFC 2119 keywords (MUST/SHOULD/MAY)
  • Rename Principle IV: "Code is Written for Humans First" -> "Readability First"
  • Replace flake8 with ruff for Python linting
  • Add Lint Configuration Awareness section
  • Add Assisted-by trailer requirement under commit trailers
  • Fix branch model to main-only (remove develop references)
  • Add constitution reference as authoritative source
  • Add Section 6 linking to AI_NATIVE_DEVELOPMENT.md

Related

@sonupreetam sonupreetam left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No blocking findings. Three minor observations below.

This review was generated by /review-pr (AI-assisted).

sonupreetam

This comment was marked as outdated.

sonupreetam

This comment was marked as duplicate.

@sonupreetam sonupreetam left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Inline Observations

STYLE_GUIDE.md, line 160[LOW] Missing period (CS-001)
The sentence ending with ...under the project's license is missing a closing period before the parenthetical DCO link.

AI_NATIVE_DEVELOPMENT.md, line 230[MEDIUM] Hardcoded command names may become stale (DR-002)
The Quick Reference table hardcodes specific command names (/speckit.specify, /opsx-propose, /opsx-apply, /unleash, /review-council, /review-pr). If any are renamed, this table becomes misleading. Consider noting that per-repo docs/AI.md is the canonical source for current commands.

AI_NATIVE_DEVELOPMENT.md, line 146[LOW] External URL may become stale
The link to https://github.com/unbound-force/unbound-force assumes this repo name/org remain stable. Consider referencing a docs page or redirect URL the org controls.

This review was generated by /review-pr (AI-assisted).

@beatrizmcouto beatrizmcouto requested a review from gvauter May 11, 2026 13:22
Create AI_NATIVE_DEVELOPMENT.md as the org-wide single source of truth for
AI-native development. Covers philosophy, 5-step workflow, file classification,
convention pack system, disclosure standards (Assisted-by trailer),
agent-agnostic principle, continuous improvement loop, and quick reference.

Update STYLE_GUIDE.md to align with constitution v1.2.0:
- Normalize to RFC 2119 keywords (MUST/SHOULD/MAY)
- Rename Principle IV to 'Readability First'
- Replace flake8 with ruff for Python linting
- Add Lint Configuration Awareness section
- Add Assisted-by trailer requirement under commit trailers
- Fix branch model (main-only, remove develop references)
- Add constitution reference as authoritative source
- Add Section 6 linking to AI_NATIVE_DEVELOPMENT.md

Assisted-by: OpenCode (claude-opus-4-6)
Signed-off-by: Marcus Burghardt <[email protected]>
Command names in the Quick Reference tables may change over time.
Add a note pointing to per-repo docs/AI.md as the canonical source
for up-to-date command references.

Assisted-by: OpenCode (claude-opus-4-6)
Signed-off-by: Marcus Burghardt <[email protected]>
@marcusburghardt marcusburghardt force-pushed the standardize-ai-native-development branch from a4abdfd to 19558bc Compare May 11, 2026 14:46
@marcusburghardt

Copy link
Copy Markdown
Member Author

Addressed in a4abdfd:

  • STYLE_GUIDE.md line 160 (missing period): Not applicable -- the period is correctly placed after the closing parenthesis on line 162; the parenthetical is part of the sentence.
  • AI_NATIVE_DEVELOPMENT.md line 230 (hardcoded commands): Fixed -- added a note pointing to per-repo docs/AI.md as the canonical source for current commands.
  • AI_NATIVE_DEVELOPMENT.md line 146 (external URL): Kept as-is -- no plans to change the URL, and if it does change, broader updates would be required anyway.

@gvauter gvauter left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@marcusburghardt marcusburghardt merged commit 8479380 into complytime:main May 12, 2026
@marcusburghardt marcusburghardt deleted the standardize-ai-native-development branch May 12, 2026 06:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants