Skip to content

docs: ratify project constitution v1.0.0#104

Merged
muzahidul-opti merged 5 commits intomasterfrom
docs/add-project-constitution
Apr 30, 2026
Merged

docs: ratify project constitution v1.0.0#104
muzahidul-opti merged 5 commits intomasterfrom
docs/add-project-constitution

Conversation

@muzahidul-opti
Copy link
Copy Markdown
Contributor

Summary

  • Add project constitution (.specify/memory/constitution.md) with 8 core principles: Bridge Pattern Integrity, Response Object Pattern (non-negotiable), Platform Parity, Type Safety Across the Bridge, Thread Safety, Multi-Instance State Isolation, Version Synchronisation (non-negotiable), and Native SDK Version Pinning
  • Add Platform Compatibility Standards section (minimum versions, language/tooling, licensing)
  • Add Development Workflow & Quality Gates section (branching, testing, commits, CI, feature checklist, CLA)
  • Add Governance section with amendment procedure and compliance expectations
  • Exclude .specify/ from pub.dev release package via .pubignore
  • Add Spec Kit framework files to .gitignore

Test plan

  • Verify .specify/memory/constitution.md contains no placeholder tokens
  • Verify .pubignore excludes .specify/
  • Verify .gitignore excludes speckit framework files but allows .specify/memory/
  • Run flutter pub publish --dry-run to confirm .specify/ is excluded from package

🤖 Generated with Claude Code

muzahidul-opti and others added 4 commits April 29, 2026 21:32
Add Optimizely Flutter SDK constitution with 8 core principles
covering bridge pattern integrity, response object pattern, platform
parity, type safety, thread safety, multi-instance isolation, version
synchronisation, and native SDK version pinning. Includes platform
compatibility standards and development workflow quality gates.

Also excludes .specify/ from pub.dev release package via .pubignore
and adds speckit framework files to .gitignore.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@muzahidul-opti muzahidul-opti marked this pull request as draft April 30, 2026 15:37
Comment thread CLAUDE.md
@alexjoeyyong
Copy link
Copy Markdown

https://github.com/optimizely/flags/blob/master/.github/copilot-instructions.md

Recommend also adding in copilot-instructions like in flags here instructing copilot to use the constitution for reviews.

jaeopt
jaeopt previously approved these changes Apr 30, 2026
Copy link
Copy Markdown
Contributor

@jaeopt jaeopt left a comment

Choose a reason for hiding this comment

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

LGTM

Address PR#104 review feedback:
- Add Project Constitution section in CLAUDE.md emphasizing use for
  all changes (including day-to-day work not requiring full SDD)
- Create .github/copilot-instructions.md to instruct GitHub Copilot
  to follow the project constitution during code generation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@muzahidul-opti muzahidul-opti marked this pull request as ready for review April 30, 2026 16:50
@muzahidul-opti muzahidul-opti merged commit 4ccc706 into master Apr 30, 2026
6 checks passed
@muzahidul-opti muzahidul-opti deleted the docs/add-project-constitution branch April 30, 2026 16:51
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