From fd72706c815ac9e729108ad1350a2baabd125c01 Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Sun, 22 Mar 2026 23:57:27 -0600 Subject: [PATCH] docs: update tech-spec references to spec --- docs/_STYLE_GUIDE.md | 2 +- docs/explanation/established-projects-faq.md | 4 ++-- docs/explanation/project-context.md | 2 +- docs/fr/reference/workflow-map.md | 2 +- docs/fr/tutorials/getting-started.md | 2 +- docs/reference/workflow-map.md | 2 +- docs/tutorials/getting-started.md | 4 ++-- docs/zh-cn/_STYLE_GUIDE.md | 2 +- docs/zh-cn/explanation/established-projects-faq.md | 2 +- docs/zh-cn/reference/workflow-map.md | 2 +- src/bmm-skills/module-help.csv | 4 ++-- 11 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/_STYLE_GUIDE.md b/docs/_STYLE_GUIDE.md index 5256d2bf5..d23e93114 100644 --- a/docs/_STYLE_GUIDE.md +++ b/docs/_STYLE_GUIDE.md @@ -56,7 +56,7 @@ Critical warnings only — data loss, security issues | Phase | Name | What Happens | | ----- | -------- | -------------------------------------------- | | 1 | Analysis | Brainstorm, research *(optional)* | -| 2 | Planning | Requirements — PRD or tech-spec *(required)* | +| 2 | Planning | Requirements — PRD or spec *(required)* | ``` **Skills:** diff --git a/docs/explanation/established-projects-faq.md b/docs/explanation/established-projects-faq.md index fe217fcdd..9671dd171 100644 --- a/docs/explanation/established-projects-faq.md +++ b/docs/explanation/established-projects-faq.md @@ -34,7 +34,7 @@ Yes! Quick Flow works great for established projects. It will: - Auto-detect your existing stack - Analyze existing code patterns - Detect conventions and ask for confirmation -- Generate context-rich tech-spec that respects existing code +- Generate context-rich spec that respects existing code Perfect for bug fixes and small features in existing codebases. @@ -43,7 +43,7 @@ Perfect for bug fixes and small features in existing codebases. Quick Flow detects your conventions and asks: "Should I follow these existing conventions?" You decide: - **Yes** → Maintain consistency with current codebase -- **No** → Establish new standards (document why in tech-spec) +- **No** → Establish new standards (document why in spec) BMM respects your choice — it won't force modernization, but it will offer it. diff --git a/docs/explanation/project-context.md b/docs/explanation/project-context.md index 7b4eba4ed..b7cce90ff 100644 --- a/docs/explanation/project-context.md +++ b/docs/explanation/project-context.md @@ -25,7 +25,7 @@ Every implementation workflow automatically loads `project-context.md` if it exi - `bmad-create-story` — informs story creation with project patterns - `bmad-dev-story` — guides implementation decisions - `bmad-code-review` — validates against project standards -- `bmad-quick-dev` — applies patterns when implementing tech-specs +- `bmad-quick-dev` — applies patterns when implementing specs - `bmad-sprint-planning`, `bmad-retrospective`, `bmad-correct-course` — provides project-wide context ## When to Create It diff --git a/docs/fr/reference/workflow-map.md b/docs/fr/reference/workflow-map.md index a26106682..50821c6fd 100644 --- a/docs/fr/reference/workflow-map.md +++ b/docs/fr/reference/workflow-map.md @@ -68,7 +68,7 @@ Sautez les phases 1-3 pour les travaux de faible envergure et bien compris. | Workflow | Objectif | Produit | |------------------|-------------------------------------------------------------------------------------|-----------------------| -| `bmad-quick-dev` | Flux rapide unifié — clarifie l'intention, planifie, implémente, révise et présente | `tech-spec.md` + code | +| `bmad-quick-dev` | Flux rapide unifié — clarifie l'intention, planifie, implémente, révise et présente | `spec-*.md` + code | ## Gestion du Contexte diff --git a/docs/fr/tutorials/getting-started.md b/docs/fr/tutorials/getting-started.md index c0502f23a..70d6e3095 100644 --- a/docs/fr/tutorials/getting-started.md +++ b/docs/fr/tutorials/getting-started.md @@ -233,7 +233,7 @@ your-project/ ## Questions fréquentes **Ai-je toujours besoin d'une architecture ?** -Uniquement pour les voies méthode BMad et Enterprise. Quick Dev passe directement de la spécification technique (tech-spec) à l'implémentation. +Uniquement pour les voies méthode BMad et Enterprise. Quick Dev passe directement de la spécification technique (spec) à l'implémentation. **Puis-je modifier mon plan plus tard ?** Oui. Utilisez `bmad-correct-course` pour gérer les changements de périmètre. diff --git a/docs/reference/workflow-map.md b/docs/reference/workflow-map.md index 7fd4cae67..9f5e7e7ed 100644 --- a/docs/reference/workflow-map.md +++ b/docs/reference/workflow-map.md @@ -68,7 +68,7 @@ Skip phases 1-3 for small, well-understood work. | Workflow | Purpose | Produces | | ------------------ | --------------------------------------------------------------------------- | ---------------------- | -| `bmad-quick-dev` | Unified quick flow — clarify intent, plan, implement, review, and present | `tech-spec.md` + code | +| `bmad-quick-dev` | Unified quick flow — clarify intent, plan, implement, review, and present | `spec-*.md` + code | ## Context Management diff --git a/docs/tutorials/getting-started.md b/docs/tutorials/getting-started.md index ee68eb6ce..d6d1f08dd 100644 --- a/docs/tutorials/getting-started.md +++ b/docs/tutorials/getting-started.md @@ -69,7 +69,7 @@ BMad helps you build software through guided workflows with specialized AI agent | Phase | Name | What Happens | | ----- | -------------- | --------------------------------------------------- | | 1 | Analysis | Brainstorming, research, product brief *(optional)* | -| 2 | Planning | Create requirements (PRD or tech-spec) | +| 2 | Planning | Create requirements (PRD or spec) | | 3 | Solutioning | Design architecture *(BMad Method/Enterprise only)* | | 4 | Implementation | Build epic by epic, story by story | @@ -237,7 +237,7 @@ your-project/ ## Common Questions **Do I always need architecture?** -Only for BMad Method and Enterprise tracks. Quick Flow skips from tech-spec to implementation. +Only for BMad Method and Enterprise tracks. Quick Flow skips from spec to implementation. **Can I change my plan later?** Yes. The SM agent has a `bmad-correct-course` workflow (`bmad-correct-course`) for handling scope changes. diff --git a/docs/zh-cn/_STYLE_GUIDE.md b/docs/zh-cn/_STYLE_GUIDE.md index 53904e219..93d3c2739 100644 --- a/docs/zh-cn/_STYLE_GUIDE.md +++ b/docs/zh-cn/_STYLE_GUIDE.md @@ -56,7 +56,7 @@ Critical warnings only — data loss, security issues | Phase | Name | What Happens | | ----- | -------- | -------------------------------------------- | | 1 | Analysis | Brainstorm, research *(optional)* | -| 2 | Planning | Requirements — PRD or tech-spec *(required)* | +| 2 | Planning | Requirements — PRD or spec *(required)* | ``` **Commands:** diff --git a/docs/zh-cn/explanation/established-projects-faq.md b/docs/zh-cn/explanation/established-projects-faq.md index dcf89df2c..6b37a98b6 100644 --- a/docs/zh-cn/explanation/established-projects-faq.md +++ b/docs/zh-cn/explanation/established-projects-faq.md @@ -54,7 +54,7 @@ BMM 尊重你的选择——它不会强制现代化，但会提供现代化选 - **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。 - **Quick Flow**：快速流程。BMad 方法中的一种工作流程，用于快速处理既有项目。 -- **tech-spec**：技术规范。描述技术实现细节和标准的文档。 +- **spec**：规范。描述技术实现细节和标准的文档。 - **stack**：技术栈。项目所使用的技术组合，包括框架、库、工具等。 - **conventions**：约定。代码库中遵循的编码风格、命名规则等规范。 - **modernization**：现代化。将旧代码或系统更新为更现代的技术和最佳实践的过程。 diff --git a/docs/zh-cn/reference/workflow-map.md b/docs/zh-cn/reference/workflow-map.md index c8a20ff9c..7c74efe70 100644 --- a/docs/zh-cn/reference/workflow-map.md +++ b/docs/zh-cn/reference/workflow-map.md @@ -68,7 +68,7 @@ BMad Method（BMM）是 BMad 生态系统中的一个模块，旨在遵循上下 | 工作流程 | 目的 | 产出 | | --------------------- | --------------------------------------------------------------------------- | --------------------------- | -| `bmad-bmm-quick-dev` | 统一快速流程 — 澄清意图、规划、实现、审查和呈现 | `tech-spec.md` + 代码 | +| `bmad-bmm-quick-dev` | 统一快速流程 — 澄清意图、规划、实现、审查和呈现 | `spec-*.md` + 代码 | ## 上下文管理 diff --git a/src/bmm-skills/module-help.csv b/src/bmm-skills/module-help.csv index 6e27cb3e2..696688cc4 100644 --- a/src/bmm-skills/module-help.csv +++ b/src/bmm-skills/module-help.csv @@ -1,7 +1,7 @@ module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs, bmm,anytime,Document Project,DP,,skill:bmad-document-project,bmad-bmm-document-project,false,analyst,Create Mode,"Analyze an existing project to produce useful documentation",project-knowledge,*, -bmm,anytime,Generate Project Context,GPC,,skill:bmad-generate-project-context,bmad-bmm-generate-project-context,false,analyst,Create Mode,"Scan existing codebase to generate a lean LLM-optimized project-context.md containing critical implementation rules patterns and conventions for AI agents. Essential for brownfield projects and quick-flow.",output_folder,"project context", -bmm,anytime,Quick Dev,QQ,,skill:bmad-quick-dev,bmad-bmm-quick-dev,false,quick-flow-solo-dev,Create Mode,"Unified quick flow: clarify intent plan implement review and present in a single workflow",implementation_artifacts,"tech spec and project implementation", +bmm,anytime,Generate Project Context,GPC,,skill:bmad-generate-project-context,bmad-bmm-generate-project-context,false,analyst,Create Mode,"Scan existing codebase to generate a lean LLM-optimized project-context.md containing critical implementation rules patterns and conventions for AI agents. Essential for brownfield projects.",output_folder,"project context", +bmm,anytime,Quick Dev,QQ,,skill:bmad-quick-dev,bmad-bmm-quick-dev,false,quick-flow-solo-dev,Create Mode,"Unified intent-in code-out workflow: clarify plan implement review and present",implementation_artifacts,"spec and project implementation", bmm,anytime,Correct Course,CC,,skill:bmad-correct-course,bmad-bmm-correct-course,false,sm,Create Mode,"Anytime: Navigate significant changes. May recommend start over update PRD redo architecture sprint planning or correct epics and stories",planning_artifacts,"change proposal", bmm,anytime,Write Document,WD,,skill:bmad-agent-tech-writer,,false,tech-writer,,"Describe in detail what you want, and the agent will follow the documentation best practices defined in agent memory. Multi-turn conversation with subprocess for research/review.",project-knowledge,"document", bmm,anytime,Update Standards,US,,skill:bmad-agent-tech-writer,,false,tech-writer,,"Update agent memory documentation-standards.md with your specific preferences if you discover missing document conventions.",_bmad/_memory/tech-writer-sidecar,"standards",