Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
55 commits
Select commit Hold shift + click to select a range
7fa3a77
chore: generate project charter for coder-ddev governance
rfay May 7, 2026
e69728a
Add spec for feature github-org-gated-signup-01KR1P4G
rfay May 7, 2026
c630c2b
Add meta for feature github-org-gated-signup-01KR1P4G
rfay May 7, 2026
2a09a3c
feat(spec): specify GitHub org-gated signup for coder.ddev.com
rfay May 7, 2026
9794dbc
chore: commit spec-kitty init artifacts and CI drupal-contrib addition
rfay May 7, 2026
18e9a42
revert validate.yml change that belongs in another worktree
rfay May 7, 2026
e6ae58d
Add plan for feature github-org-gated-signup-01KR1P4G
rfay May 7, 2026
8fa7b05
feat(plan): add implementation plan and research for github-org-gated…
rfay May 7, 2026
daf3ea6
feat(spec): add org README, access-request repo, and blog post update…
rfay May 7, 2026
d494035
feat(spec): add sponsor org access requirements (FR-013, FR-014, C-00…
rfay May 7, 2026
d07f3a6
feat(research): resolve sponsor GitHub org slugs, add platformsh alon…
rfay May 7, 2026
9a05348
feat(spec): add 8mylez, remove lets-talk, add sponsor notification task
rfay May 7, 2026
7deb13d
feat(research): add dkd, liip, dougvann; finalize ALLOWED_ORGS list
rfay May 7, 2026
4cadb38
feat(research): add all featured sponsors to ALLOWED_ORGS, exclude in…
rfay May 7, 2026
e4ad8b5
chore: Map requirements for WP01, WP02, WP03, WP04 on spec github
rfay May 7, 2026
ce56ac0
chore: Map requirements for WP01 on spec github
rfay May 7, 2026
e672064
chore: Map requirements for WP02 on spec github
rfay May 7, 2026
1c34c2c
Add tasks for feature github-org-gated-signup-01KR1P4G
rfay May 7, 2026
6e73737
Add plan for feature github-org-gated-signup-01KR1P4G
rfay May 7, 2026
8d985f8
Add tasks for feature github-org-gated-signup-01KR1P4G
rfay May 7, 2026
d0a0af1
chore: WP01 claimed for implementation
rfay May 7, 2026
e125c1d
chore: planning artifacts for github-org-gated-signup-01KR1P4G
rfay May 7, 2026
0f4c50c
chore: Start WP01 implementation [claude]
rfay May 7, 2026
d8a378f
feat(WP01): update server-setup.md for org-gated auth
rfay May 7, 2026
732ace1
chore: Move WP01 to for_review on spec github [claude]
rfay May 7, 2026
c5947e8
chore: planning artifacts for github-org-gated-signup-01KR1P4G
rfay May 7, 2026
bdf9c6d
chore: WP02 claimed for implementation
rfay May 7, 2026
6b283ba
chore: Start WP02 implementation [claude]
rfay May 7, 2026
ef16a15
feat(WP02): add Access Management section to user-management.md
rfay May 7, 2026
ce785cd
chore: Move WP02 to for_review on spec github [claude]
rfay May 7, 2026
8a6c2ba
chore: Start WP03 implementation [claude]
rfay May 7, 2026
a2c734f
feat(WP03): add coder-ddev-com org content drafts
rfay May 7, 2026
c4ef67e
chore: update mission events for WP03 claim
rfay May 7, 2026
a05f989
chore: Move WP03 to for_review on spec github [claude]
rfay May 7, 2026
fc09a35
chore: Start WP04 implementation [claude]
rfay May 7, 2026
20670ca
feat(WP04): add blog post update draft for org-gated signup
rfay May 7, 2026
5ae65e4
chore: update mission events for WP04 claim
rfay May 7, 2026
625d4a2
chore: Move WP04 to for_review on spec github [claude]
rfay May 7, 2026
9d366a5
chore: update mission events for WP01 review
rfay May 7, 2026
d898d26
chore: Move WP01 to approved on spec github [claude]
rfay May 7, 2026
f8ddafe
chore: update mission events
rfay May 7, 2026
7f33899
chore: Move WP02 to approved on spec github [claude]
rfay May 7, 2026
fd9b6da
chore: update mission events for WP03 review
rfay May 7, 2026
5e97046
chore: Move WP03 to approved on spec github [claude]
rfay May 7, 2026
ef4b4b1
chore: update mission events for WP04 review
rfay May 7, 2026
69428f1
chore: Move WP04 to approved on spec github [claude]
rfay May 7, 2026
55c72d2
Merge kitty/mission-github-org-gated-signup-01KR1P4G-lane-b into kitt…
rfay May 7, 2026
a08c14c
Merge 20260507_speckitty into kitty/mission-github-org-gated-signup-0…
rfay May 7, 2026
486b440
chore(github-org-gated-signup-01KR1P4G): assign mission_number=1
rfay May 7, 2026
1573f44
chore: finalize mission event log and status after merge
rfay May 7, 2026
9c16122
fix: sync access-requests README corrections
rfay May 7, 2026
9328393
docs: update start page for org-gated auth, add access-denied page
rfay May 7, 2026
3eece69
docs: fix auth-callout wording on start page
rfay May 7, 2026
b3e6fe2
docs: add spec-kitty workflow guide
rfay May 7, 2026
0762172
docs: remove blog-post-draft, applied to ddev.com
rfay May 7, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 58 additions & 0 deletions .claudeignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# Spec Kitty Configuration and Templates
# These are internal directories that shouldn't be scanned by AI assistants

# Template directories (not working code)
.kittify/templates/
.kittify/missions/
.kittify/scripts/

# Agent command directories (generated from templates, not source)
.claude/
.codex/
.gemini/
.cursor/
.qwen/
.opencode/
.windsurf/
.kilocode/
.augment/
.roo/
.amazonq/
.github/copilot/

# Git metadata
.git/

# Build artifacts and caches
__pycache__/
*.pyc
*.pyo
.pytest_cache/
.coverage
htmlcov/
node_modules/
dist/
build/
*.egg-info/

# Virtual environments
.venv/
venv/
env/

# OS-specific files
.DS_Store
Thumbs.db
desktop.ini

# IDE directories
.vscode/
.idea/
*.swp
*.swo
*~

# Logs and databases
*.log
*.db
*.sqlite
1 change: 1 addition & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
kitty-specs/**/status.events.jsonl merge=spec-kitty-event-log
2 changes: 1 addition & 1 deletion .github/workflows/validate.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ jobs:
runs-on: ubuntu-latest
strategy:
matrix:
template: [user-defined-web, drupal-core, drupal-contrib, freeform]
template: [user-defined-web, drupal-core, freeform]
fail-fast: false
steps:
- uses: actions/checkout@v6
Expand Down
29 changes: 29 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -9,3 +9,32 @@ __pycache__/

# Temp files
composer.json.tmp

# Added by Spec Kitty CLI (auto-managed)
.claude/
.codex/
.vibe/
.opencode/
.windsurf/
.gemini/
.cursor/
.qwen/
.kilocode/
.augment/
.roo/
.amazonq/
.kiro/
.agent/
.github/copilot/
.kittify/.dashboard
.kittify/charter/context-state.json
.kittify/charter/directives.yaml
.kittify/charter/governance.yaml
.kittify/charter/metadata.yaml
.kittify/charter/references.yaml
.kittify/dossiers/
.kittify/events/
.kittify/merge-state.json
.kittify/missions/__pycache__/
.kittify/runtime/
.kittify/workspaces/
77 changes: 77 additions & 0 deletions .kittify/charter/charter.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
# Project Charter

<!-- Generated by `spec-kitty charter generate` -->

Generated: 2026-05-07T16:47:53Z

## Testing Standards

- Integration tests are BATS scripts that run against a live staging Coder instance (staging-coder.ddev.com) before any deployment to production. Plan-level tests use `terraform test` (no real infrastructure required). CI also runs `terraform fmt -check -recursive` and `terraform validate` for each touched template. There is no unit-test coverage percentage target — correctness is verified by staging promotion.


## Quality Gates

- All changes require a pull request. CI must pass before merge. CI gates: `terraform fmt -check`, `terraform validate`, `terraform test` for each template. Integration test scripts run against staging before promoting to production. No direct commits to main.


## Performance Benchmarks

- No quantitative latency targets. Workspace startup should complete within a reasonable time (under 5 minutes) as a qualitative target. CLI commands (terraform, make) should not timeout during CI runs.


## Branch Strategy

- Every change requires a pull request. Single maintainer project currently, but PRs still required for traceability and CI gating. Conventional commit messages are preferred.

- Deployment constraints: Two environments: staging-coder.ddev.com and production coder.ddev.com. Templates are promoted staging → production only after integration tests pass on staging. The main branch reflects the production-ready state. Feature branches are used for all development work.


## Governance Activation

```yaml
mission: software-dev
selected_paradigms: []
selected_directives: []
available_tools: [git, spec-kitty]
template_set: software-dev-default
```

## Policy Summary

- Intent: Manage and deploy coder.ddev.com — a cloud-hosted DDEV environment for web developers. The project owns the Coder workspace templates (Terraform HCL), the base Docker image, and the supporting shell scripts that enable Docker-in-Docker development via Sysbox runtime. A breaking change means developers cannot create or use workspaces; risk level is high for end users who depend on the service.

- Languages/Frameworks: Terraform (HCL), Shell (Bash), Dockerfile (Ubuntu 24.04 base), bats-core (BATS test framework for shell-level integration tests), Go toolchain (available in image for future use).

- Testing: Integration tests are BATS scripts that run against a live staging Coder instance (staging-coder.ddev.com) before any deployment to production. Plan-level tests use `terraform test` (no real infrastructure required). CI also runs `terraform fmt -check -recursive` and `terraform validate` for each touched template. There is no unit-test coverage percentage target — correctness is verified by staging promotion.

- Quality Gates: All changes require a pull request. CI must pass before merge. CI gates: `terraform fmt -check`, `terraform validate`, `terraform test` for each template. Integration test scripts run against staging before promoting to production. No direct commits to main.

- Review Policy: Every change requires a pull request. Single maintainer project currently, but PRs still required for traceability and CI gating. Conventional commit messages are preferred.

- Performance Targets: No quantitative latency targets. Workspace startup should complete within a reasonable time (under 5 minutes) as a qualitative target. CLI commands (terraform, make) should not timeout during CI runs.

- Deployment Constraints: Two environments: staging-coder.ddev.com and production coder.ddev.com. Templates are promoted staging → production only after integration tests pass on staging. The main branch reflects the production-ready state. Feature branches are used for all development work.


## Project Directives

1. Respect risk boundaries: High-risk changes: modifications to startup scripts, Sysbox runtime configuration, Docker daemon setup, or base image layers — these affect all workspaces. Medium-risk: template variable changes or new templates. Low-risk: documentation, Makefile targets, version bumps. Any change that affects running workspaces requires staging validation.

2. Keep documentation synchronized with workflow and behavior changes.

## Reference Index

| Reference ID | Kind | Summary | Local Doc |
|---|---|---|---|
| `USER:PROJECT_PROFILE` | user_profile | Project-specific interview answers captured for charter compilation. | `_LIBRARY/user-project-profile.md` |
| `TEMPLATE_SET:software-dev-default` | template_set | Build high-quality software with structured workflows and test-driven development | `_LIBRARY/template-set-software-dev-default.md` |

## Amendment Process

Charter amendments follow the same PR process as code changes. Significant governance changes should be discussed in the PR description.


## Exception Policy

Hotfixes for production incidents may bypass staging testing with explicit maintainer acknowledgment in the PR, but must still pass CI.

79 changes: 79 additions & 0 deletions .kittify/charter/interview/answers.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
schema_version: "1.0.0"
mission: "software-dev"
profile: "comprehensive"
answers:
project_intent: >
Manage and deploy coder.ddev.com — a cloud-hosted DDEV environment for
web developers. The project owns the Coder workspace templates (Terraform HCL),
the base Docker image, and the supporting shell scripts that enable
Docker-in-Docker development via Sysbox runtime. A breaking change means
developers cannot create or use workspaces; risk level is high for end users
who depend on the service.

languages_frameworks: >
Terraform (HCL), Shell (Bash), Dockerfile (Ubuntu 24.04 base),
bats-core (BATS test framework for shell-level integration tests),
Go toolchain (available in image for future use).

testing_requirements: >
Integration tests are BATS scripts that run against a live staging Coder
instance (staging-coder.ddev.com) before any deployment to production.
Plan-level tests use `terraform test` (no real infrastructure required).
CI also runs `terraform fmt -check -recursive` and `terraform validate`
for each touched template. There is no unit-test coverage percentage target —
correctness is verified by staging promotion.

quality_gates: >
All changes require a pull request. CI must pass before merge.
CI gates: `terraform fmt -check`, `terraform validate`, `terraform test`
for each template. Integration test scripts run against staging before
promoting to production. No direct commits to main.

review_policy: >
Every change requires a pull request. Single maintainer project currently,
but PRs still required for traceability and CI gating. Conventional commit
messages are preferred.

performance_targets: >
No quantitative latency targets. Workspace startup should complete within
a reasonable time (under 5 minutes) as a qualitative target. CLI commands
(terraform, make) should not timeout during CI runs.

deployment_constraints: >
Two environments: staging-coder.ddev.com and production coder.ddev.com.
Templates are promoted staging → production only after integration tests
pass on staging. The main branch reflects the production-ready state.
Feature branches are used for all development work.

documentation_policy: >
User-facing documentation lives in /docs/. CLAUDE.md documents developer
and contributor guidance. Changes to template behavior or CLI commands
must be reflected in docs before merge. Doc-only changes are low-risk
but still require PRs.

risk_boundaries: >
High-risk changes: modifications to startup scripts, Sysbox runtime
configuration, Docker daemon setup, or base image layers — these affect
all workspaces. Medium-risk: template variable changes or new templates.
Low-risk: documentation, Makefile targets, version bumps.
Any change that affects running workspaces requires staging validation.

amendment_process: >
Charter amendments follow the same PR process as code changes.
Significant governance changes should be discussed in the PR description.

exception_policy: >
Hotfixes for production incidents may bypass staging testing with explicit
maintainer acknowledgment in the PR, but must still pass CI.

selected_paradigms: []

selected_directives: []

available_tools:
- git
- spec-kitty
- terraform
- docker
- make
- bats
11 changes: 11 additions & 0 deletions .kittify/config.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
vcs:
type: git
agents:
available:
- claude
auto_commit: true
project:
uuid: 595dcc83-8eee-4a87-8644-84d94a4b531c
slug: coder-ddev
node_id: a1b8182ad705
build_id: ea439b9d-ce91-4e8c-a458-0f28a54b80bc
Loading