@cubis/foundry 0.3.78 → 0.3.80

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (81) hide show
  1. package/dist/cli/build/commands.js +1 -1
  2. package/dist/cli/build/commands.js.map +1 -1
  3. package/dist/cli/core.js +752 -101
  4. package/dist/cli/core.js.map +1 -1
  5. package/package.json +1 -1
  6. package/src/cli/build/commands.ts +1 -1
  7. package/src/cli/core.ts +884 -114
  8. package/workflows/workflows/agent-environment-setup/generated/route-manifest.json +2 -2
  9. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/accessibility.toml +1 -1
  10. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/architecture.toml +2 -2
  11. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/backend.toml +1 -1
  12. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/create.toml +1 -1
  13. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/database.toml +1 -1
  14. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/debug.toml +1 -1
  15. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/devops.toml +1 -1
  16. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/implement-track.toml +1 -1
  17. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/migrate.toml +1 -1
  18. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/mobile.toml +1 -1
  19. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/onboard.toml +1 -1
  20. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/orchestrate.toml +1 -1
  21. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/plan.toml +1 -1
  22. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/refactor.toml +1 -1
  23. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/release.toml +1 -1
  24. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/review.toml +1 -1
  25. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/security.toml +1 -1
  26. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/spec.toml +1 -1
  27. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/test.toml +1 -1
  28. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/vercel.toml +1 -1
  29. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/architecture.md +20 -15
  30. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/spec.md +2 -2
  31. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/architecture.md +20 -15
  32. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/spec.md +2 -2
  33. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/architecture.md +20 -15
  34. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/spec.md +2 -2
  35. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-accessibility.prompt.md +1 -1
  36. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-architecture.prompt.md +2 -2
  37. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-backend.prompt.md +1 -1
  38. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-create.prompt.md +1 -1
  39. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-database.prompt.md +1 -1
  40. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-debug.prompt.md +1 -1
  41. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-devops.prompt.md +1 -1
  42. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-implement-track.prompt.md +1 -1
  43. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-migrate.prompt.md +1 -1
  44. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-mobile.prompt.md +1 -1
  45. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-onboard.prompt.md +1 -1
  46. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-orchestrate.prompt.md +1 -1
  47. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-plan.prompt.md +1 -1
  48. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-refactor.prompt.md +1 -1
  49. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-release.prompt.md +1 -1
  50. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-review.prompt.md +1 -1
  51. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-security.prompt.md +1 -1
  52. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-spec.prompt.md +1 -1
  53. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-test.prompt.md +1 -1
  54. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-vercel.prompt.md +1 -1
  55. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/architecture.md +20 -15
  56. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/spec.md +2 -2
  57. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/accessibility.toml +1 -1
  58. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/architecture.toml +2 -2
  59. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/backend.toml +1 -1
  60. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/create.toml +1 -1
  61. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/database.toml +1 -1
  62. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/debug.toml +1 -1
  63. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/devops.toml +1 -1
  64. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/implement-track.toml +1 -1
  65. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/migrate.toml +1 -1
  66. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/mobile.toml +1 -1
  67. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/onboard.toml +1 -1
  68. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/orchestrate.toml +1 -1
  69. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/plan.toml +1 -1
  70. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/refactor.toml +1 -1
  71. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/release.toml +1 -1
  72. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/review.toml +1 -1
  73. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/security.toml +1 -1
  74. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/spec.toml +1 -1
  75. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/test.toml +1 -1
  76. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/vercel.toml +1 -1
  77. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/architecture.md +20 -15
  78. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/spec.md +2 -2
  79. package/workflows/workflows/agent-environment-setup/shared/rules/STEERING.md +3 -3
  80. package/workflows/workflows/agent-environment-setup/shared/workflows/architecture.md +20 -15
  81. package/workflows/workflows/agent-environment-setup/shared/workflows/spec.md +2 -2
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "cubis-foundry-route-manifest-v1",
3
3
  "generatedAt": "1970-01-01T00:00:00.000Z",
4
- "contentHash": "84d671504acfd27c",
4
+ "contentHash": "899035d77675ed16",
5
5
  "summary": {
6
6
  "totalRoutes": 42,
7
7
  "workflows": 20,
@@ -1211,7 +1211,7 @@
1211
1211
  "id": "architecture",
1212
1212
  "command": "/architecture",
1213
1213
  "displayName": "architecture",
1214
- "description": "Refresh the project architecture contract and current-state map in ENGINEERING_RULES.md and TECH.md with explicit structure, design-system, testing, and flow guidance.",
1214
+ "description": "Refresh the core project foundation docs in docs/foundation/PRODUCT.md, docs/foundation/ARCHITECTURE.md, docs/foundation/TECH.md, and ADR scaffolds with explicit structure, product context, testing, and flow guidance.",
1215
1215
  "triggers": [
1216
1216
  "architecture",
1217
1217
  "design system",
@@ -4,7 +4,7 @@ Follow the /accessibility workflow from .agent/workflows/accessibility.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `code-review`, `frontend-design`, `performance-testing`, `react`, `nextjs`, `playwright-interactive`, `typescript-best-practices`, `javascript-best-practices`.
10
10
  - Local skill file hints if installed: `.agent/skills/code-review/SKILL.md`, `.agent/skills/frontend-design/SKILL.md`, `.agent/skills/performance-testing/SKILL.md`, `.agent/skills/react/SKILL.md`, `.agent/skills/nextjs/SKILL.md`, `.agent/skills/playwright-interactive/SKILL.md`, `.agent/skills/typescript-best-practices/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`.
@@ -1,10 +1,10 @@
1
- description = "Refresh the project architecture contract and current-state map in ENGINEERING_RULES.md and TECH.md with explicit structure, design-system, testing, and flow guidance."
1
+ description = "Refresh the core project foundation docs in docs/foundation/PRODUCT.md, docs/foundation/ARCHITECTURE.md, docs/foundation/TECH.md, and ADR scaffolds with explicit structure, product context, testing, and flow guidance."
2
2
  prompt = '''
3
3
  Follow the /architecture workflow from .agent/workflows/architecture.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `architecture-doc`, `system-design`, `tech-doc`, `frontend-design`, `api-design`, `database-design`, `sadd`, `deep-research`.
10
10
  - Local skill file hints if installed: `.agent/skills/architecture-doc/SKILL.md`, `.agent/skills/system-design/SKILL.md`, `.agent/skills/tech-doc/SKILL.md`, `.agent/skills/frontend-design/SKILL.md`, `.agent/skills/api-design/SKILL.md`, `.agent/skills/database-design/SKILL.md`, `.agent/skills/sadd/SKILL.md`, `.agent/skills/deep-research/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /backend workflow from .agent/workflows/backend.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `api-design`, `javascript-best-practices`, `owasp-security-review`, `database-design`, `nestjs`, `fastapi`, `microservices-design`, `drizzle-orm`, `stripe-integration`, `ci-cd-pipeline`, `frontend-design`, `typescript-best-practices`, `python-best-practices`, `golang-best-practices`.
10
10
  - Local skill file hints if installed: `.agent/skills/api-design/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`, `.agent/skills/owasp-security-review/SKILL.md`, `.agent/skills/database-design/SKILL.md`, `.agent/skills/nestjs/SKILL.md`, `.agent/skills/fastapi/SKILL.md`, `.agent/skills/microservices-design/SKILL.md`, `.agent/skills/drizzle-orm/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /create workflow from .agent/workflows/create.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`, `java-best-practices`, `csharp-best-practices`, `kotlin-best-practices`, `rust-best-practices`, `php-best-practices`, `expo-app`, `swift-best-practices`, `api-design`, `nestjs`, `fastapi`, `drizzle-orm`, `database-design`, `mcp-server-builder`, `stitch`, `react`, `nextjs`, `frontend-design`, `performance-testing`, `skill-creator`, `stripe-integration`, `ci-cd-pipeline`.
10
10
  - Local skill file hints if installed: `.agent/skills/typescript-best-practices/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`, `.agent/skills/python-best-practices/SKILL.md`, `.agent/skills/golang-best-practices/SKILL.md`, `.agent/skills/java-best-practices/SKILL.md`, `.agent/skills/csharp-best-practices/SKILL.md`, `.agent/skills/kotlin-best-practices/SKILL.md`, `.agent/skills/rust-best-practices/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /database workflow from .agent/workflows/database.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `database-design`, `drizzle-orm`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`.
10
10
  - Local skill file hints if installed: `.agent/skills/database-design/SKILL.md`, `.agent/skills/drizzle-orm/SKILL.md`, `.agent/skills/typescript-best-practices/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`, `.agent/skills/python-best-practices/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /debug workflow from .agent/workflows/debug.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `systematic-debugging`, `observability`, `unit-testing`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`, `java-best-practices`, `csharp-best-practices`, `kotlin-best-practices`, `rust-best-practices`, `integration-testing`, `playwright-interactive`, `skill-creator`.
10
10
  - Local skill file hints if installed: `.agent/skills/systematic-debugging/SKILL.md`, `.agent/skills/observability/SKILL.md`, `.agent/skills/unit-testing/SKILL.md`, `.agent/skills/typescript-best-practices/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`, `.agent/skills/python-best-practices/SKILL.md`, `.agent/skills/golang-best-practices/SKILL.md`, `.agent/skills/java-best-practices/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /devops workflow from .agent/workflows/devops.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `ci-cd-pipeline`, `kubernetes-deploy`, `observability`, `git-workflow`, `systematic-debugging`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`.
10
10
  - Local skill file hints if installed: `.agent/skills/ci-cd-pipeline/SKILL.md`, `.agent/skills/kubernetes-deploy/SKILL.md`, `.agent/skills/observability/SKILL.md`, `.agent/skills/git-workflow/SKILL.md`, `.agent/skills/systematic-debugging/SKILL.md`, `.agent/skills/typescript-best-practices/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`, `.agent/skills/python-best-practices/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /implement-track workflow from .agent/workflows/implement-track.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `system-design`, `api-design`, `database-design`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`, `react`, `nextjs`.
10
10
  - Local skill file hints if installed: `.agent/skills/system-design/SKILL.md`, `.agent/skills/api-design/SKILL.md`, `.agent/skills/database-design/SKILL.md`, `.agent/skills/typescript-best-practices/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`, `.agent/skills/python-best-practices/SKILL.md`, `.agent/skills/golang-best-practices/SKILL.md`, `.agent/skills/react/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /migrate workflow from .agent/workflows/migrate.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `system-design`, `code-review`, `unit-testing`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`.
10
10
  - Local skill file hints if installed: `.agent/skills/system-design/SKILL.md`, `.agent/skills/code-review/SKILL.md`, `.agent/skills/unit-testing/SKILL.md`, `.agent/skills/typescript-best-practices/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`, `.agent/skills/python-best-practices/SKILL.md`, `.agent/skills/golang-best-practices/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /mobile workflow from .agent/workflows/mobile.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `expo-app`, `react-native`, `stitch`, `frontend-design`, `swift-best-practices`, `kotlin-best-practices`.
10
10
  - Local skill file hints if installed: `.agent/skills/expo-app/SKILL.md`, `.agent/skills/react-native/SKILL.md`, `.agent/skills/stitch/SKILL.md`, `.agent/skills/frontend-design/SKILL.md`, `.agent/skills/swift-best-practices/SKILL.md`, `.agent/skills/kotlin-best-practices/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /onboard workflow from .agent/workflows/onboard.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `deep-research`, `system-design`, `database-design`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`.
10
10
  - Local skill file hints if installed: `.agent/skills/deep-research/SKILL.md`, `.agent/skills/system-design/SKILL.md`, `.agent/skills/database-design/SKILL.md`, `.agent/skills/typescript-best-practices/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`, `.agent/skills/python-best-practices/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /orchestrate workflow from .agent/workflows/orchestrate.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `system-design`, `api-design`, `database-design`, `deep-research`, `mcp-server-builder`, `tech-doc`, `prompt-engineering`, `skill-creator`.
10
10
  - Local skill file hints if installed: `.agent/skills/system-design/SKILL.md`, `.agent/skills/api-design/SKILL.md`, `.agent/skills/database-design/SKILL.md`, `.agent/skills/deep-research/SKILL.md`, `.agent/skills/mcp-server-builder/SKILL.md`, `.agent/skills/tech-doc/SKILL.md`, `.agent/skills/prompt-engineering/SKILL.md`, `.agent/skills/skill-creator/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /plan workflow from .agent/workflows/plan.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `system-design`, `api-design`, `database-design`, `deep-research`, `mcp-server-builder`, `tech-doc`, `prompt-engineering`, `skill-creator`.
10
10
  - Local skill file hints if installed: `.agent/skills/system-design/SKILL.md`, `.agent/skills/api-design/SKILL.md`, `.agent/skills/database-design/SKILL.md`, `.agent/skills/deep-research/SKILL.md`, `.agent/skills/mcp-server-builder/SKILL.md`, `.agent/skills/tech-doc/SKILL.md`, `.agent/skills/prompt-engineering/SKILL.md`, `.agent/skills/skill-creator/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /refactor workflow from .agent/workflows/refactor.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `code-review`, `system-design`, `unit-testing`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`.
10
10
  - Local skill file hints if installed: `.agent/skills/code-review/SKILL.md`, `.agent/skills/system-design/SKILL.md`, `.agent/skills/unit-testing/SKILL.md`, `.agent/skills/typescript-best-practices/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`, `.agent/skills/python-best-practices/SKILL.md`, `.agent/skills/golang-best-practices/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /release workflow from .agent/workflows/release.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `ci-cd-pipeline`, `git-workflow`, `tech-doc`, `observability`, `kubernetes-deploy`, `typescript-best-practices`, `javascript-best-practices`.
10
10
  - Local skill file hints if installed: `.agent/skills/ci-cd-pipeline/SKILL.md`, `.agent/skills/git-workflow/SKILL.md`, `.agent/skills/tech-doc/SKILL.md`, `.agent/skills/observability/SKILL.md`, `.agent/skills/kubernetes-deploy/SKILL.md`, `.agent/skills/typescript-best-practices/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /review workflow from .agent/workflows/review.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `code-review`, `unit-testing`, `owasp-security-review`, `performance-testing`, `react`, `nextjs`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`.
10
10
  - Local skill file hints if installed: `.agent/skills/code-review/SKILL.md`, `.agent/skills/unit-testing/SKILL.md`, `.agent/skills/owasp-security-review/SKILL.md`, `.agent/skills/performance-testing/SKILL.md`, `.agent/skills/react/SKILL.md`, `.agent/skills/nextjs/SKILL.md`, `.agent/skills/typescript-best-practices/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /security workflow from .agent/workflows/security.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `owasp-security-review`, `code-review`, `api-design`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`, `rust-best-practices`.
10
10
  - Local skill file hints if installed: `.agent/skills/owasp-security-review/SKILL.md`, `.agent/skills/code-review/SKILL.md`, `.agent/skills/api-design/SKILL.md`, `.agent/skills/typescript-best-practices/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`, `.agent/skills/python-best-practices/SKILL.md`, `.agent/skills/golang-best-practices/SKILL.md`, `.agent/skills/rust-best-practices/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /spec workflow from .agent/workflows/spec.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `spec-driven-delivery`, `sadd`, `system-design`, `architecture-doc`, `deep-research`, `api-design`, `database-design`, `tech-doc`.
10
10
  - Local skill file hints if installed: `.agent/skills/spec-driven-delivery/SKILL.md`, `.agent/skills/sadd/SKILL.md`, `.agent/skills/system-design/SKILL.md`, `.agent/skills/architecture-doc/SKILL.md`, `.agent/skills/deep-research/SKILL.md`, `.agent/skills/api-design/SKILL.md`, `.agent/skills/database-design/SKILL.md`, `.agent/skills/tech-doc/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /test workflow from .agent/workflows/test.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `unit-testing`, `integration-testing`, `playwright-interactive`, `observability`, `systematic-debugging`, `code-review`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`, `java-best-practices`.
10
10
  - Local skill file hints if installed: `.agent/skills/unit-testing/SKILL.md`, `.agent/skills/integration-testing/SKILL.md`, `.agent/skills/playwright-interactive/SKILL.md`, `.agent/skills/observability/SKILL.md`, `.agent/skills/systematic-debugging/SKILL.md`, `.agent/skills/code-review/SKILL.md`, `.agent/skills/typescript-best-practices/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`.
@@ -4,7 +4,7 @@ Follow the /vercel workflow from .agent/workflows/vercel.md.
4
4
 
5
5
  Execution contract:
6
6
  1. Treat route selection as already resolved by this command; do not begin with skill discovery.
7
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
7
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
8
8
  Attached skills:
9
9
  - Load these exact skill IDs first: `nextjs`, `ci-cd-pipeline`, `performance-testing`, `react`, `frontend-design`, `javascript-best-practices`, `typescript-best-practices`.
10
10
  - Local skill file hints if installed: `.agent/skills/nextjs/SKILL.md`, `.agent/skills/ci-cd-pipeline/SKILL.md`, `.agent/skills/performance-testing/SKILL.md`, `.agent/skills/react/SKILL.md`, `.agent/skills/frontend-design/SKILL.md`, `.agent/skills/javascript-best-practices/SKILL.md`, `.agent/skills/typescript-best-practices/SKILL.md`.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  command: "/architecture"
3
- description: "Refresh the project architecture contract and current-state map in ENGINEERING_RULES.md and TECH.md with explicit structure, design-system, testing, and flow guidance."
3
+ description: "Refresh the core project foundation docs in docs/foundation/PRODUCT.md, docs/foundation/ARCHITECTURE.md, docs/foundation/TECH.md, and ADR scaffolds with explicit structure, product context, testing, and flow guidance."
4
4
  triggers:
5
5
  [
6
6
  "architecture",
@@ -18,7 +18,7 @@ triggers:
18
18
 
19
19
  ## When to use
20
20
 
21
- Use this when the task is to declare, refresh, or validate the project architecture contract and current-state map, especially after structure changes, scale changes, design-system changes, migrations, or major feature additions.
21
+ Use this when the task is to declare, refresh, or validate the project backbone docs, especially after structure changes, scale changes, design-system changes, migrations, product-direction shifts, or major feature additions.
22
22
 
23
23
  ## Routing
24
24
 
@@ -35,24 +35,27 @@ Use this when the task is to declare, refresh, or validate the project architect
35
35
 
36
36
  ## Workflow steps
37
37
 
38
- 1. Inspect the repo first and read `ENGINEERING_RULES.md` followed by `TECH.md` if they exist.
39
- 2. Determine the current architecture style, module boundaries, design-system source of truth, and testing strategy from the codebase.
40
- 3. Update only the managed architecture sections in `ENGINEERING_RULES.md` and `TECH.md`.
41
- 4. Add or refresh Mermaid diagrams and flow narratives inside `TECH.md` when they clarify system behavior.
42
- 5. Record whether the update was driven by a broader spec and whether future implementation must follow newly declared rules.
38
+ 1. Inspect the repo first and derive the current product surfaces, architecture style, module boundaries, technical constraints, and testing strategy from the codebase itself.
39
+ 2. Read concrete repo anchors before drafting: root README/manifests, main entrypoints, the primary app roots, existing `docs/specs/`, and representative source folders for each major surface.
40
+ 3. Read `docs/foundation/PRODUCT.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order if they exist.
41
+ 4. Update the managed foundation sections in `docs/foundation/PRODUCT.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md`.
42
+ 5. Add or refresh Mermaid diagrams and flow narratives inside `docs/foundation/ARCHITECTURE.md` or `docs/foundation/TECH.md` when they clarify system behavior.
43
+ 6. Seed or refresh `docs/foundation/adr/README.md` and `docs/foundation/adr/0000-template.md`, and keep ADR linkage explicit when decisions should be durable.
44
+ 7. Record whether the update was driven by a broader spec and whether future implementation must follow newly declared structure or product constraints.
43
45
 
44
46
  ## Context notes
45
47
 
46
48
  - This workflow is route-fixed and skill-fixed: do not start with `route_resolve` or `skill_search`.
47
- - `ENGINEERING_RULES.md` is normative. `TECH.md` is descriptive. Keep them aligned but not redundant.
48
- - Preserve manual content outside the managed architecture sections.
49
+ - `docs/foundation/PRODUCT.md` captures intent, `docs/foundation/ARCHITECTURE.md` captures accepted structure, and `docs/foundation/TECH.md` is the developer-facing technical map. Keep them aligned but not redundant.
50
+ - Favor a lean arc42/C4 style: clear scope, boundaries, building blocks, runtime flows, deployment/testing notes, and only diagrams that add real value.
51
+ - Preserve manual content outside the managed foundation sections.
49
52
  - Mark non-applicable sections explicitly instead of silently omitting them.
50
53
 
51
54
  ## Verification
52
55
 
53
- - Managed architecture sections exist in both target docs.
54
- - Architecture style, dependency rules, and design-system guidance are explicit.
55
- - `TECH.md` includes flow text and at least one Mermaid diagram when the repo has meaningful flow complexity.
56
+ - Managed foundation sections exist in the target docs under `docs/foundation/`.
57
+ - Product intent, architecture style, dependency rules, and technical guidance are explicit.
58
+ - `docs/foundation/ARCHITECTURE.md` or `docs/foundation/TECH.md` includes flow text and at least one Mermaid diagram when the repo has meaningful flow complexity.
56
59
  - The update records `doc_impact` and whether future feature work must refresh the docs again.
57
60
 
58
61
  ## Output Contract
@@ -64,9 +67,11 @@ ARCHITECTURE_WORKFLOW_RESULT:
64
67
  primary_skills: [architecture-doc, system-design, tech-doc, frontend-design]
65
68
  supporting_skills: [api-design?, database-design?, sadd?, deep-research?]
66
69
  managed_targets:
67
- rules_doc: ENGINEERING_RULES.md
68
- tech_doc: TECH.md
69
- files_updated: [ENGINEERING_RULES.md, TECH.md]
70
+ product_doc: docs/foundation/PRODUCT.md
71
+ architecture_doc: docs/foundation/ARCHITECTURE.md
72
+ tech_doc: docs/foundation/TECH.md
73
+ adr_dir: docs/foundation/adr
74
+ files_updated: [docs/foundation/PRODUCT.md, docs/foundation/ARCHITECTURE.md, docs/foundation/TECH.md]
70
75
  architecture_contract:
71
76
  style: <string>
72
77
  dependency_rules: [<string>]
@@ -38,12 +38,12 @@ Use this for non-trivial work that needs durable planning in Git before implemen
38
38
  1. Determine whether the task is non-trivial enough to justify a spec pack.
39
39
  2. Find an existing `docs/specs/<spec-id>/` pack or create a new stable `spec_id`.
40
40
  3. Write or refresh the spec pack with brief, acceptance, tasks, traceability, and handoff files.
41
- 4. Record `architecture_impact`, `doc_impact`, and any required updates to `ENGINEERING_RULES.md` or `TECH.md`.
41
+ 4. Record `architecture_impact`, `doc_impact`, and any required updates to `docs/foundation/PRODUCT.md`, `docs/foundation/ARCHITECTURE.md`, `ENGINEERING_RULES.md`, or `docs/foundation/TECH.md`.
42
42
  5. Identify the next execution route and hand off without replanning the same work.
43
43
 
44
44
  ## Context notes
45
45
 
46
- - Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist because they define the accepted architecture contract and current state.
46
+ - Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist because they define the accepted product direction, architecture contract, and current state.
47
47
  - Prefer repo evidence first; escalate to `deep-research` only when freshness, public comparison, or explicit research requests require it.
48
48
  - Keep spec packs lean. Trivial one-step tasks should stay on the lightweight path with no new spec directory.
49
49
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  command: "/architecture"
3
- description: "Refresh the project architecture contract and current-state map in ENGINEERING_RULES.md and TECH.md with explicit structure, design-system, testing, and flow guidance."
3
+ description: "Refresh the core project foundation docs in docs/foundation/PRODUCT.md, docs/foundation/ARCHITECTURE.md, docs/foundation/TECH.md, and ADR scaffolds with explicit structure, product context, testing, and flow guidance."
4
4
  triggers:
5
5
  [
6
6
  "architecture",
@@ -18,7 +18,7 @@ triggers:
18
18
 
19
19
  ## When to use
20
20
 
21
- Use this when the task is to declare, refresh, or validate the project architecture contract and current-state map, especially after structure changes, scale changes, design-system changes, migrations, or major feature additions.
21
+ Use this when the task is to declare, refresh, or validate the project backbone docs, especially after structure changes, scale changes, design-system changes, migrations, product-direction shifts, or major feature additions.
22
22
 
23
23
  ## Routing
24
24
 
@@ -35,24 +35,27 @@ Use this when the task is to declare, refresh, or validate the project architect
35
35
 
36
36
  ## Workflow steps
37
37
 
38
- 1. Inspect the repo first and read `ENGINEERING_RULES.md` followed by `TECH.md` if they exist.
39
- 2. Determine the current architecture style, module boundaries, design-system source of truth, and testing strategy from the codebase.
40
- 3. Update only the managed architecture sections in `ENGINEERING_RULES.md` and `TECH.md`.
41
- 4. Add or refresh Mermaid diagrams and flow narratives inside `TECH.md` when they clarify system behavior.
42
- 5. Record whether the update was driven by a broader spec and whether future implementation must follow newly declared rules.
38
+ 1. Inspect the repo first and derive the current product surfaces, architecture style, module boundaries, technical constraints, and testing strategy from the codebase itself.
39
+ 2. Read concrete repo anchors before drafting: root README/manifests, main entrypoints, the primary app roots, existing `docs/specs/`, and representative source folders for each major surface.
40
+ 3. Read `docs/foundation/PRODUCT.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order if they exist.
41
+ 4. Update the managed foundation sections in `docs/foundation/PRODUCT.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md`.
42
+ 5. Add or refresh Mermaid diagrams and flow narratives inside `docs/foundation/ARCHITECTURE.md` or `docs/foundation/TECH.md` when they clarify system behavior.
43
+ 6. Seed or refresh `docs/foundation/adr/README.md` and `docs/foundation/adr/0000-template.md`, and keep ADR linkage explicit when decisions should be durable.
44
+ 7. Record whether the update was driven by a broader spec and whether future implementation must follow newly declared structure or product constraints.
43
45
 
44
46
  ## Context notes
45
47
 
46
48
  - This workflow is route-fixed and skill-fixed: do not start with `route_resolve` or `skill_search`.
47
- - `ENGINEERING_RULES.md` is normative. `TECH.md` is descriptive. Keep them aligned but not redundant.
48
- - Preserve manual content outside the managed architecture sections.
49
+ - `docs/foundation/PRODUCT.md` captures intent, `docs/foundation/ARCHITECTURE.md` captures accepted structure, and `docs/foundation/TECH.md` is the developer-facing technical map. Keep them aligned but not redundant.
50
+ - Favor a lean arc42/C4 style: clear scope, boundaries, building blocks, runtime flows, deployment/testing notes, and only diagrams that add real value.
51
+ - Preserve manual content outside the managed foundation sections.
49
52
  - Mark non-applicable sections explicitly instead of silently omitting them.
50
53
 
51
54
  ## Verification
52
55
 
53
- - Managed architecture sections exist in both target docs.
54
- - Architecture style, dependency rules, and design-system guidance are explicit.
55
- - `TECH.md` includes flow text and at least one Mermaid diagram when the repo has meaningful flow complexity.
56
+ - Managed foundation sections exist in the target docs under `docs/foundation/`.
57
+ - Product intent, architecture style, dependency rules, and technical guidance are explicit.
58
+ - `docs/foundation/ARCHITECTURE.md` or `docs/foundation/TECH.md` includes flow text and at least one Mermaid diagram when the repo has meaningful flow complexity.
56
59
  - The update records `doc_impact` and whether future feature work must refresh the docs again.
57
60
 
58
61
  ## Output Contract
@@ -64,9 +67,11 @@ ARCHITECTURE_WORKFLOW_RESULT:
64
67
  primary_skills: [architecture-doc, system-design, tech-doc, frontend-design]
65
68
  supporting_skills: [api-design?, database-design?, sadd?, deep-research?]
66
69
  managed_targets:
67
- rules_doc: ENGINEERING_RULES.md
68
- tech_doc: TECH.md
69
- files_updated: [ENGINEERING_RULES.md, TECH.md]
70
+ product_doc: docs/foundation/PRODUCT.md
71
+ architecture_doc: docs/foundation/ARCHITECTURE.md
72
+ tech_doc: docs/foundation/TECH.md
73
+ adr_dir: docs/foundation/adr
74
+ files_updated: [docs/foundation/PRODUCT.md, docs/foundation/ARCHITECTURE.md, docs/foundation/TECH.md]
70
75
  architecture_contract:
71
76
  style: <string>
72
77
  dependency_rules: [<string>]
@@ -38,12 +38,12 @@ Use this for non-trivial work that needs durable planning in Git before implemen
38
38
  1. Determine whether the task is non-trivial enough to justify a spec pack.
39
39
  2. Find an existing `docs/specs/<spec-id>/` pack or create a new stable `spec_id`.
40
40
  3. Write or refresh the spec pack with brief, acceptance, tasks, traceability, and handoff files.
41
- 4. Record `architecture_impact`, `doc_impact`, and any required updates to `ENGINEERING_RULES.md` or `TECH.md`.
41
+ 4. Record `architecture_impact`, `doc_impact`, and any required updates to `docs/foundation/PRODUCT.md`, `docs/foundation/ARCHITECTURE.md`, `ENGINEERING_RULES.md`, or `docs/foundation/TECH.md`.
42
42
  5. Identify the next execution route and hand off without replanning the same work.
43
43
 
44
44
  ## Context notes
45
45
 
46
- - Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist because they define the accepted architecture contract and current state.
46
+ - Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist because they define the accepted product direction, architecture contract, and current state.
47
47
  - Prefer repo evidence first; escalate to `deep-research` only when freshness, public comparison, or explicit research requests require it.
48
48
  - Keep spec packs lean. Trivial one-step tasks should stay on the lightweight path with no new spec directory.
49
49
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  command: "/architecture"
3
- description: "Refresh the project architecture contract and current-state map in ENGINEERING_RULES.md and TECH.md with explicit structure, design-system, testing, and flow guidance."
3
+ description: "Refresh the core project foundation docs in docs/foundation/PRODUCT.md, docs/foundation/ARCHITECTURE.md, docs/foundation/TECH.md, and ADR scaffolds with explicit structure, product context, testing, and flow guidance."
4
4
  triggers:
5
5
  [
6
6
  "architecture",
@@ -18,7 +18,7 @@ triggers:
18
18
 
19
19
  ## When to use
20
20
 
21
- Use this when the task is to declare, refresh, or validate the project architecture contract and current-state map, especially after structure changes, scale changes, design-system changes, migrations, or major feature additions.
21
+ Use this when the task is to declare, refresh, or validate the project backbone docs, especially after structure changes, scale changes, design-system changes, migrations, product-direction shifts, or major feature additions.
22
22
 
23
23
  ## Routing
24
24
 
@@ -35,24 +35,27 @@ Use this when the task is to declare, refresh, or validate the project architect
35
35
 
36
36
  ## Workflow steps
37
37
 
38
- 1. Inspect the repo first and read `ENGINEERING_RULES.md` followed by `TECH.md` if they exist.
39
- 2. Determine the current architecture style, module boundaries, design-system source of truth, and testing strategy from the codebase.
40
- 3. Update only the managed architecture sections in `ENGINEERING_RULES.md` and `TECH.md`.
41
- 4. Add or refresh Mermaid diagrams and flow narratives inside `TECH.md` when they clarify system behavior.
42
- 5. Record whether the update was driven by a broader spec and whether future implementation must follow newly declared rules.
38
+ 1. Inspect the repo first and derive the current product surfaces, architecture style, module boundaries, technical constraints, and testing strategy from the codebase itself.
39
+ 2. Read concrete repo anchors before drafting: root README/manifests, main entrypoints, the primary app roots, existing `docs/specs/`, and representative source folders for each major surface.
40
+ 3. Read `docs/foundation/PRODUCT.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order if they exist.
41
+ 4. Update the managed foundation sections in `docs/foundation/PRODUCT.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md`.
42
+ 5. Add or refresh Mermaid diagrams and flow narratives inside `docs/foundation/ARCHITECTURE.md` or `docs/foundation/TECH.md` when they clarify system behavior.
43
+ 6. Seed or refresh `docs/foundation/adr/README.md` and `docs/foundation/adr/0000-template.md`, and keep ADR linkage explicit when decisions should be durable.
44
+ 7. Record whether the update was driven by a broader spec and whether future implementation must follow newly declared structure or product constraints.
43
45
 
44
46
  ## Context notes
45
47
 
46
48
  - This workflow is route-fixed and skill-fixed: do not start with `route_resolve` or `skill_search`.
47
- - `ENGINEERING_RULES.md` is normative. `TECH.md` is descriptive. Keep them aligned but not redundant.
48
- - Preserve manual content outside the managed architecture sections.
49
+ - `docs/foundation/PRODUCT.md` captures intent, `docs/foundation/ARCHITECTURE.md` captures accepted structure, and `docs/foundation/TECH.md` is the developer-facing technical map. Keep them aligned but not redundant.
50
+ - Favor a lean arc42/C4 style: clear scope, boundaries, building blocks, runtime flows, deployment/testing notes, and only diagrams that add real value.
51
+ - Preserve manual content outside the managed foundation sections.
49
52
  - Mark non-applicable sections explicitly instead of silently omitting them.
50
53
 
51
54
  ## Verification
52
55
 
53
- - Managed architecture sections exist in both target docs.
54
- - Architecture style, dependency rules, and design-system guidance are explicit.
55
- - `TECH.md` includes flow text and at least one Mermaid diagram when the repo has meaningful flow complexity.
56
+ - Managed foundation sections exist in the target docs under `docs/foundation/`.
57
+ - Product intent, architecture style, dependency rules, and technical guidance are explicit.
58
+ - `docs/foundation/ARCHITECTURE.md` or `docs/foundation/TECH.md` includes flow text and at least one Mermaid diagram when the repo has meaningful flow complexity.
56
59
  - The update records `doc_impact` and whether future feature work must refresh the docs again.
57
60
 
58
61
  ## Output Contract
@@ -64,9 +67,11 @@ ARCHITECTURE_WORKFLOW_RESULT:
64
67
  primary_skills: [architecture-doc, system-design, tech-doc, frontend-design]
65
68
  supporting_skills: [api-design?, database-design?, sadd?, deep-research?]
66
69
  managed_targets:
67
- rules_doc: ENGINEERING_RULES.md
68
- tech_doc: TECH.md
69
- files_updated: [ENGINEERING_RULES.md, TECH.md]
70
+ product_doc: docs/foundation/PRODUCT.md
71
+ architecture_doc: docs/foundation/ARCHITECTURE.md
72
+ tech_doc: docs/foundation/TECH.md
73
+ adr_dir: docs/foundation/adr
74
+ files_updated: [docs/foundation/PRODUCT.md, docs/foundation/ARCHITECTURE.md, docs/foundation/TECH.md]
70
75
  architecture_contract:
71
76
  style: <string>
72
77
  dependency_rules: [<string>]
@@ -38,12 +38,12 @@ Use this for non-trivial work that needs durable planning in Git before implemen
38
38
  1. Determine whether the task is non-trivial enough to justify a spec pack.
39
39
  2. Find an existing `docs/specs/<spec-id>/` pack or create a new stable `spec_id`.
40
40
  3. Write or refresh the spec pack with brief, acceptance, tasks, traceability, and handoff files.
41
- 4. Record `architecture_impact`, `doc_impact`, and any required updates to `ENGINEERING_RULES.md` or `TECH.md`.
41
+ 4. Record `architecture_impact`, `doc_impact`, and any required updates to `docs/foundation/PRODUCT.md`, `docs/foundation/ARCHITECTURE.md`, `ENGINEERING_RULES.md`, or `docs/foundation/TECH.md`.
42
42
  5. Identify the next execution route and hand off without replanning the same work.
43
43
 
44
44
  ## Context notes
45
45
 
46
- - Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist because they define the accepted architecture contract and current state.
46
+ - Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist because they define the accepted product direction, architecture contract, and current state.
47
47
  - Prefer repo evidence first; escalate to `deep-research` only when freshness, public comparison, or explicit research requests require it.
48
48
  - Keep spec packs lean. Trivial one-step tasks should stay on the lightweight path with no new spec directory.
49
49
 
@@ -7,7 +7,7 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
10
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
11
11
  Attached skills:
12
12
  - Load these exact skill IDs first: `code-review`, `frontend-design`, `performance-testing`, `react`, `nextjs`, `playwright-interactive`, `typescript-best-practices`, `javascript-best-practices`.
13
13
  - Local skill file hints if installed: `.github/skills/code-review/SKILL.md`, `.github/skills/frontend-design/SKILL.md`, `.github/skills/performance-testing/SKILL.md`, `.github/skills/react/SKILL.md`, `.github/skills/nextjs/SKILL.md`, `.github/skills/playwright-interactive/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`.
@@ -1,13 +1,13 @@
1
1
  # Workflow Prompt: /architecture
2
2
 
3
- Refresh the project architecture contract and current-state map in ENGINEERING_RULES.md and TECH.md with explicit structure, design-system, testing, and flow guidance.
3
+ Refresh the core project foundation docs in docs/foundation/PRODUCT.md, docs/foundation/ARCHITECTURE.md, docs/foundation/TECH.md, and ADR scaffolds with explicit structure, product context, testing, and flow guidance.
4
4
 
5
5
  Use this prompt with the matching workflow file:
6
6
  - Workflow: ../copilot/workflows/architecture.md
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
10
+ 2. Read `docs/foundation/PRODUCT.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
11
11
  Attached skills:
12
12
  - Load these exact skill IDs first: `architecture-doc`, `system-design`, `tech-doc`, `frontend-design`, `api-design`, `database-design`, `sadd`, `deep-research`.
13
13
  - Local skill file hints if installed: `.github/skills/architecture-doc/SKILL.md`, `.github/skills/system-design/SKILL.md`, `.github/skills/tech-doc/SKILL.md`, `.github/skills/frontend-design/SKILL.md`, `.github/skills/api-design/SKILL.md`, `.github/skills/database-design/SKILL.md`, `.github/skills/sadd/SKILL.md`, `.github/skills/deep-research/SKILL.md`.
@@ -7,7 +7,7 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
10
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
11
11
  Attached skills:
12
12
  - Load these exact skill IDs first: `api-design`, `javascript-best-practices`, `owasp-security-review`, `database-design`, `nestjs`, `fastapi`, `microservices-design`, `drizzle-orm`, `stripe-integration`, `ci-cd-pipeline`, `frontend-design`, `typescript-best-practices`, `python-best-practices`, `golang-best-practices`.
13
13
  - Local skill file hints if installed: `.github/skills/api-design/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/owasp-security-review/SKILL.md`, `.github/skills/database-design/SKILL.md`, `.github/skills/nestjs/SKILL.md`, `.github/skills/fastapi/SKILL.md`, `.github/skills/microservices-design/SKILL.md`, `.github/skills/drizzle-orm/SKILL.md`.
@@ -7,7 +7,7 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
10
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
11
11
  Attached skills:
12
12
  - Load these exact skill IDs first: `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`, `java-best-practices`, `csharp-best-practices`, `kotlin-best-practices`, `rust-best-practices`, `php-best-practices`, `expo-app`, `swift-best-practices`, `api-design`, `nestjs`, `fastapi`, `drizzle-orm`, `database-design`, `mcp-server-builder`, `stitch`, `react`, `nextjs`, `frontend-design`, `performance-testing`, `skill-creator`, `stripe-integration`, `ci-cd-pipeline`.
13
13
  - Local skill file hints if installed: `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/python-best-practices/SKILL.md`, `.github/skills/golang-best-practices/SKILL.md`, `.github/skills/java-best-practices/SKILL.md`, `.github/skills/csharp-best-practices/SKILL.md`, `.github/skills/kotlin-best-practices/SKILL.md`, `.github/skills/rust-best-practices/SKILL.md`.
@@ -7,7 +7,7 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
10
+ 2. Read `docs/foundation/PRODUCT.md`, `ENGINEERING_RULES.md`, `docs/foundation/ARCHITECTURE.md`, and `docs/foundation/TECH.md` in that order when they exist before non-trivial execution.
11
11
  Attached skills:
12
12
  - Load these exact skill IDs first: `database-design`, `drizzle-orm`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`.
13
13
  - Local skill file hints if installed: `.github/skills/database-design/SKILL.md`, `.github/skills/drizzle-orm/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/python-best-practices/SKILL.md`.