Skip to content

Migrate design documents and speckit assets from design_notes repository#11553

Open
nicolejms wants to merge 6 commits intoradius-project:mainfrom
nicolejms:migrate_design
Open

Migrate design documents and speckit assets from design_notes repository#11553
nicolejms wants to merge 6 commits intoradius-project:mainfrom
nicolejms:migrate_design

Conversation

@nicolejms
Copy link
Copy Markdown
Contributor

@nicolejms nicolejms commented Apr 3, 2026

Description

Moving all the design documents from the design_notes repository based on the migration plan signed off by the team.

Type of change

Movement of files from design_notes to radius so copilots and agents have more context for work.

  • This pull request is a minor refactor, code cleanup, test improvement, or other maintenance task and doesn't change the functionality of Radius (issue link optional).

Fixes: n/a

Contributor checklist

Please verify that the PR meets the following requirements, where applicable:

  • An overview of proposed schema changes is included in a linked GitHub issue.
    • Yes
    • Not applicable
  • A design document PR is created in the design-notes repository, if new APIs are being introduced.
    • Yes
    • Not applicable
  • The design document has been reviewed and approved by Radius maintainers/approvers.
    • Yes
    • Not applicable
  • A PR for the samples repository is created, if existing samples are affected by the changes in this PR.
    • Yes
    • Not applicable
  • A PR for the documentation repository is created, if the changes in this PR affect the documentation or any user facing updates are made.
    • Yes
    • Not applicable
  • A PR for the recipes repository is created, if existing recipes are affected by the changes in this PR.
    • Yes
    • Not applicable

@nicolejms nicolejms requested review from a team as code owners April 3, 2026 20:41
Copilot AI review requested due to automatic review settings April 3, 2026 20:41
@nicolejms nicolejms requested a deployment to external-contributor-approval April 3, 2026 20:41 — with GitHub Actions Waiting
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR migrates design/specification documentation and Spec Kit-related assets into the repository to improve local context for contributors and automation.

Changes:

  • Added multiple Spec Kit feature specs/plans/research/tasks under specs/.
  • Added a large set of migrated design notes and templates under eng/design-notes/.
  • Introduced Spec Kit templates and helper scripts plus agent/prompt configuration under .specify/ and .github/.

Reviewed changes

Copilot reviewed 71 out of 130 changed files in this pull request and generated 14 comments.

Show a summary per file
File Description
specs/001-remove-bicep-types-submodule/tasks-1-go-modules.md Task breakdown doc for Go module migration plan.
specs/001-remove-bicep-types-submodule/spec.md Feature spec for removing bicep-types submodule and migrating deps.
specs/001-remove-bicep-types-submodule/research-1-go-modules.md Research notes supporting Go module migration approach.
specs/001-remove-bicep-types-submodule/plan-1-go-modules.md Implementation plan narrative for Go module migration.
specs/001-remove-bicep-types-submodule/checklists/requirements.md Spec quality checklist for the bicep-types submodule removal spec.
specs/001-lrt-current-release/tasks.md Task breakdown for LRT workflow using current release.
specs/001-lrt-current-release/spec.md Feature spec for updating long-running tests workflow behavior.
specs/001-lrt-current-release/research.md Research notes for LRT workflow changes.
specs/001-lrt-current-release/quickstart.md Quickstart guide for validating LRT workflow changes.
specs/001-lrt-current-release/plan.md Implementation plan for LRT workflow changes.
specs/001-lrt-current-release/checklists/requirements.md Spec quality checklist for the LRT workflow spec.
eng/design-notes/tools/2023-12-test-organization.md Migrated design note about functional test organization.
eng/design-notes/templates/threat-model-template.md Migrated threat model template.
eng/design-notes/templates/feature-spec-template.md Migrated feature spec template.
eng/design-notes/templates/design-template.md Migrated general design document template.
eng/design-notes/recipes/2024-04-terraform-provider-secrets.md Migrated recipe/engine design note for Terraform provider secrets.
eng/design-notes/recipes/2023-11-validate-template-path.md Migrated design note for validating Terraform module sources.
eng/design-notes/recipes/2023-11-support-insecure-registries.md Migrated design note for insecure registry support.
eng/design-notes/recipes/2023-09-populate-terraform-resourcs-ids.md Migrated design note for Terraform resource ID population.
eng/design-notes/recipes/2023-08-garbage-collection.md Migrated design note about recipe garbage collection.
eng/design-notes/recipes/2023-07-terraform-template-version.md Migrated design note on Terraform module versions handling.
eng/design-notes/README.md Index/structure documentation for migrated design notes.
eng/design-notes/guides/api-design-guidelines.md Migrated API design guidelines doc.
eng/design-notes/cli/2024-04-azure-workload-identity.md Migrated CLI design note for Azure workload identity.
.specify/templates/tasks-template.md Spec Kit tasks template.
.specify/templates/spec-template.md Spec Kit spec template.
.specify/templates/plan-template.md Spec Kit plan template.
.specify/templates/constitution-template.md Spec Kit constitution template.
.specify/templates/checklist-template.md Spec Kit checklist template.
.specify/templates/agent-file-template.md Spec Kit agent context template.
.specify/scripts/powershell/setup-plan.ps1 PowerShell helper for initializing plan docs.
.specify/scripts/powershell/common.ps1 Shared PowerShell helpers for Spec Kit scripts.
.specify/scripts/powershell/check-prerequisites.ps1 PowerShell prerequisites checker for Spec Kit workflows.
.specify/scripts/bash/setup-plan.sh Bash helper for initializing plan docs.
.specify/scripts/bash/common.sh Shared Bash helpers for Spec Kit scripts.
.specify/scripts/bash/check-prerequisites.sh Bash prerequisites checker for Spec Kit workflows.
.specify/init-options.json Spec Kit init configuration.
.github/prompts/speckit.taskstoissues.prompt.md Prompt entry for task-to-issues agent.
.github/prompts/speckit.tasks.prompt.md Prompt entry for tasks agent.
.github/prompts/speckit.specify.prompt.md Prompt entry for specify agent.
.github/prompts/speckit.plan.prompt.md Prompt entry for plan agent.
.github/prompts/speckit.implement.prompt.md Prompt entry for implement agent.
.github/prompts/speckit.constitution.prompt.md Prompt entry for constitution agent.
.github/prompts/speckit.clarify.prompt.md Prompt entry for clarify agent.
.github/prompts/speckit.checklist.prompt.md Prompt entry for checklist agent.
.github/prompts/speckit.analyze.prompt.md Prompt entry for analyze agent.
.github/prompts/radius.speckit.prompt.prompt.md Prompt entry for Radius-specific prompt agent.
.github/agents/speckit.taskstoissues.agent.md Agent definition for converting tasks to GitHub issues.
.github/agents/speckit.tasks.agent.md Agent definition for generating tasks.md.
.github/agents/speckit.specify.agent.md Agent definition for generating spec.md.
.github/agents/speckit.plan.agent.md Agent definition for generating plan.md and artifacts.
.github/agents/speckit.implement.agent.md Agent definition for implementing tasks.md.
.github/agents/speckit.constitution.agent.md Agent definition for maintaining constitution.md.
.github/agents/speckit.clarify.agent.md Agent definition for clarifying specs.
.github/agents/speckit.analyze.agent.md Agent definition for cross-artifact analysis.
.github/agents/radius.speckit.prompt.agent.md Radius-specific agent definition for generating Spec Kit prompts.

@codecov
Copy link
Copy Markdown

codecov bot commented Apr 3, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 51.39%. Comparing base (2ea450a) to head (699fe35).

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #11553      +/-   ##
==========================================
- Coverage   51.40%   51.39%   -0.01%     
==========================================
  Files         699      699              
  Lines       44156    44156              
==========================================
- Hits        22698    22696       -2     
- Misses      19291    19292       +1     
- Partials     2167     2168       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@nicolejms nicolejms requested a deployment to external-contributor-approval April 6, 2026 17:56 — with GitHub Actions Waiting
kachawla
kachawla previously approved these changes Apr 6, 2026
DariuszPorowski
DariuszPorowski previously approved these changes Apr 6, 2026
Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
@brooke-hamilton brooke-hamilton dismissed stale reviews from DariuszPorowski and kachawla via 699fe35 April 6, 2026 20:02
@brooke-hamilton brooke-hamilton deployed to external-contributor-approval April 6, 2026 20:02 — with GitHub Actions Active
@radius-functional-tests
Copy link
Copy Markdown

radius-functional-tests bot commented Apr 6, 2026

Radius functional test overview

🔍 Go to test action run

Click here to see the test run details
Name Value
Repository nicolejms/radius
Commit ref 699fe35
Unique ID func3658995dbc
Image tag pr-func3658995dbc
  • gotestsum 1.13.0
  • KinD: v0.29.0
  • Dapr: 1.14.4
  • Azure KeyVault CSI driver: 1.4.2
  • Azure Workload identity webhook: 1.3.0
  • Bicep recipe location ghcr.io/radius-project/dev/test/testrecipes/test-bicep-recipes/<name>:pr-func3658995dbc
  • Terraform recipe location http://tf-module-server.radius-test-tf-module-server.svc.cluster.local/<name>.zip (in cluster)
  • applications-rp test image location: ghcr.io/radius-project/dev/applications-rp:pr-func3658995dbc
  • dynamic-rp test image location: ghcr.io/radius-project/dev/dynamic-rp:pr-func3658995dbc
  • controller test image location: ghcr.io/radius-project/dev/controller:pr-func3658995dbc
  • ucp test image location: ghcr.io/radius-project/dev/ucpd:pr-func3658995dbc
  • deployment-engine test image location: ghcr.io/radius-project/deployment-engine:latest

Test Status

⌛ Building Radius and pushing container images for functional tests...
✅ Container images build succeeded
⌛ Publishing Bicep Recipes for functional tests...
✅ Recipe publishing succeeded
⌛ Starting corerp-cloud functional tests...
⌛ Starting ucp-cloud functional tests...
✅ ucp-cloud functional tests succeeded
✅ corerp-cloud functional tests succeeded

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.

5 participants