Skip to content

Commit faa7e86

Browse files
committed
docs: replace bare 'AI agent' / 'AI assistant' with 'coding agent' throughout
Full sweep across all documentation and user-facing CLI messages to align terminology. Bare references like 'AI agent', 'AI assistant', and 'AI Agent' are replaced with 'coding agent' or 'coding agent integration' as appropriate. Intentionally left unchanged: - 'AI coding agent' (already correct expanded form) - Deprecated --ai flag help text and error messages (describes the deprecated flag itself) - Community extension descriptions (external project text) - 'generated by an AI' in CONTRIBUTING.md (general AI, not agent)
1 parent c8e64e4 commit faa7e86

6 files changed

Lines changed: 29 additions & 29 deletions

File tree

CONTRIBUTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ cd <temp-dir>/speckit-test
102102

103103
#### Manual testing process
104104

105-
Any change that affects a slash command's behavior requires manually testing that command through an AI agent and submitting results with the PR.
105+
Any change that affects a slash command's behavior requires manually testing that command through a coding agent and submitting results with the PR.
106106

107107
1. **Identify affected commands** — use the [prompt below](#determining-which-tests-to-run) to have your agent analyze your changed files and determine which commands need testing.
108108
2. **Set up a test project** — scaffold from your local branch (see [Testing setup](#testing-setup)).

README.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -123,7 +123,7 @@ If your environment blocks access to PyPI or GitHub, see the [Enterprise / Air-G
123123

124124
### 2. Establish project principles
125125

126-
Launch your AI assistant in the project directory. Most agents expose spec-kit as `/speckit.*` slash commands; Codex CLI in skills mode uses `$speckit-*` instead.
126+
Launch your coding agent in the project directory. Most agents expose spec-kit as `/speckit.*` slash commands; Codex CLI in skills mode uses `$speckit-*` instead.
127127

128128
Use the **`/speckit.constitution`** command to create your project's governing principles and development guidelines that will guide all subsequent development.
129129

@@ -475,7 +475,7 @@ specify init --here --force
475475

476476
![Specify CLI bootstrapping a new project in the terminal](./media/specify_cli.gif)
477477

478-
You will be prompted to select the AI agent you are using. You can also proactively specify it directly in the terminal:
478+
You will be prompted to select the coding agent integration you are using. You can also proactively specify it directly in the terminal:
479479

480480
```bash
481481
specify init <project_name> --integration copilot
@@ -505,7 +505,7 @@ specify init <project_name> --integration copilot --ignore-agent-tools
505505

506506
### **STEP 1:** Establish project principles
507507

508-
Go to the project folder and run your AI agent. In our example, we're using `claude`.
508+
Go to the project folder and run your coding agent. In our example, we're using `claude`.
509509

510510
![Bootstrapping Claude Code environment](./media/bootstrap-claude-code.gif)
511511

@@ -517,7 +517,7 @@ The first step should be establishing your project's governing principles using
517517
/speckit.constitution Create principles focused on code quality, testing standards, user experience consistency, and performance requirements. Include governance for how these principles should guide technical decisions and implementation choices.
518518
```
519519

520-
This step creates or updates the `.specify/memory/constitution.md` file with your project's foundational guidelines that the AI agent will reference during specification, planning, and implementation phases.
520+
This step creates or updates the `.specify/memory/constitution.md` file with your project's foundational guidelines that the coding agent will reference during specification, planning, and implementation phases.
521521

522522
### **STEP 2:** Create project specifications
523523

@@ -725,9 +725,9 @@ The `/speckit.implement` command will:
725725
- Provide progress updates and handle errors appropriately
726726

727727
> [!IMPORTANT]
728-
> The AI agent will execute local CLI commands (such as `dotnet`, `npm`, etc.) - make sure you have the required tools installed on your machine.
728+
> The coding agent will execute local CLI commands (such as `dotnet`, `npm`, etc.) - make sure you have the required tools installed on your machine.
729729
730-
Once the implementation is complete, test the application and resolve any runtime errors that may not be visible in CLI logs (e.g., browser console errors). You can copy and paste such errors back to your AI agent for resolution.
730+
Once the implementation is complete, test the application and resolve any runtime errors that may not be visible in CLI logs (e.g., browser console errors). You can copy and paste such errors back to your coding agent for resolution.
731731

732732
</details>
733733

docs/installation.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init --here
4141
4242
### Specify Integration
4343

44-
You can proactively specify your AI agent during initialization:
44+
You can proactively specify your coding agent integration during initialization:
4545

4646
```bash
4747
uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <project_name> --integration claude
@@ -86,7 +86,7 @@ specify version
8686

8787
This helps verify you are running the official Spec Kit build from GitHub, not an unrelated package with the same name.
8888

89-
After initialization, you should see the following commands available in your AI agent:
89+
After initialization, you should see the following commands available in your coding agent:
9090

9191
- `/speckit.specify` - Create specifications
9292
- `/speckit.plan` - Generate implementation plans

docs/quickstart.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME
4242
4343
### Step 2: Define Your Constitution
4444

45-
**In your AI Agent's chat interface**, use the `/speckit.constitution` slash command to establish the core rules and principles for your project. You should provide your project's specific principles as arguments.
45+
**In your coding agent's chat interface**, use the `/speckit.constitution` slash command to establish the core rules and principles for your project. You should provide your project's specific principles as arguments.
4646

4747
```markdown
4848
/speckit.constitution This project follows a "Library-First" approach. All features must be implemented as standalone libraries first. We use TDD strictly. We prefer functional programming patterns.
@@ -159,7 +159,7 @@ Generate an actionable task list using the `/speckit.tasks` command:
159159
160160
### Step 7: Validate and Implement
161161
162-
Have your AI agent audit the implementation plan using `/speckit.analyze`:
162+
Have your coding agent audit the implementation plan using `/speckit.analyze`:
163163
164164
```bash
165165
/speckit.analyze
@@ -180,7 +180,7 @@ Finally, implement the solution:
180180
- **Don't focus on tech stack** during specification phase
181181
- **Iterate and refine** your specifications before implementation
182182
- **Validate** the plan before coding begins
183-
- **Let the AI agent handle** the implementation details
183+
- **Let the coding agent handle** the implementation details
184184
185185
## Next Steps
186186

extensions/EXTENSION-USER-GUIDE.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -153,7 +153,7 @@ This will:
153153
2. Validate the manifest
154154
3. Check compatibility with your spec-kit version
155155
4. Install to `.specify/extensions/jira/`
156-
5. Register commands with your AI agent
156+
5. Register commands with your coding agent
157157
6. Create config template
158158

159159
### Install from URL
@@ -208,7 +208,7 @@ When an extension is removed, its corresponding skills are also cleaned up autom
208208

209209
### Using Extension Commands
210210

211-
Extensions add commands that appear in your AI agent (Claude Code):
211+
Extensions add commands that appear in your coding agent (Claude Code):
212212

213213
```text
214214
# In Claude Code
@@ -780,12 +780,12 @@ specify extension add --dev /path/to/extension
780780

781781
### Command Not Available
782782

783-
**Issue**: Extension command not appearing in AI agent
783+
**Issue**: Extension command not appearing in coding agent
784784

785785
**Solutions**:
786786

787787
1. Check extension is enabled: `specify extension list`
788-
2. Restart AI agent (Claude Code)
788+
2. Restart coding agent (Claude Code)
789789
3. Check command file exists:
790790

791791
```bash
@@ -819,8 +819,8 @@ specify extension add --dev /path/to/extension
819819
**Solutions**:
820820

821821
1. Check MCP server is installed
822-
2. Check AI agent MCP configuration
823-
3. Restart AI agent
822+
2. Check coding agent MCP configuration
823+
3. Restart coding agent
824824
4. Check extension requirements: `specify extension info jira`
825825

826826
### Permission Denied

src/specify_cli/__init__.py

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -967,7 +967,7 @@ def init(
967967
ai_assistant: str = typer.Option(None, "--ai", help=AI_ASSISTANT_HELP),
968968
ai_commands_dir: str = typer.Option(None, "--ai-commands-dir", help="Directory for agent command files (required with --ai generic, e.g. .myagent/commands/)"),
969969
script_type: str = typer.Option(None, "--script", help="Script type to use: sh or ps"),
970-
ignore_agent_tools: bool = typer.Option(False, "--ignore-agent-tools", help="Skip checks for AI agent tools like Claude Code"),
970+
ignore_agent_tools: bool = typer.Option(False, "--ignore-agent-tools", help="Skip checks for coding agent tools like Claude Code"),
971971
no_git: bool = typer.Option(False, "--no-git", help="Skip git repository initialization"),
972972
here: bool = typer.Option(False, "--here", help="Initialize project in the current directory instead of creating a new one"),
973973
force: bool = typer.Option(False, "--force", help="Force merge/overwrite when using --here (skip confirmation)"),
@@ -997,18 +997,18 @@ def init(
997997
998998
This command will:
999999
1. Check that required tools are installed (git is optional)
1000-
2. Let you choose your AI assistant
1000+
2. Let you choose your coding agent integration
10011001
3. Download template from GitHub (or use bundled assets with --offline)
10021002
4. Initialize a fresh git repository (if not --no-git and no existing repo)
1003-
5. Optionally set up AI assistant commands
1003+
5. Optionally set up coding agent integration commands
10041004
10051005
Examples:
10061006
specify init my-project
10071007
specify init my-project --integration claude
10081008
specify init my-project --integration copilot --no-git
10091009
specify init --ignore-agent-tools my-project
10101010
specify init . --integration claude # Initialize in current directory
1011-
specify init . # Initialize in current directory (interactive AI selection)
1011+
specify init . # Initialize in current directory (interactive integration selection)
10121012
specify init --here --integration claude # Alternative syntax for current directory
10131013
specify init --here --integration codex --integration-options="--skills"
10141014
specify init --here --integration codebuddy
@@ -1170,7 +1170,7 @@ def init(
11701170
ai_choices = {key: config["name"] for key, config in AGENT_CONFIG.items()}
11711171
selected_ai = select_with_arrows(
11721172
ai_choices,
1173-
"Choose your AI assistant:",
1173+
"Choose your coding agent integration:",
11741174
"copilot"
11751175
)
11761176

@@ -1241,7 +1241,7 @@ def init(
12411241
else:
12421242
selected_script = default_script
12431243

1244-
console.print(f"[cyan]Selected AI assistant:[/cyan] {selected_ai}")
1244+
console.print(f"[cyan]Selected coding agent integration:[/cyan] {selected_ai}")
12451245
console.print(f"[cyan]Selected script type:[/cyan] {selected_script}")
12461246

12471247
tracker = StepTracker("Initialize Specify Project")
@@ -1250,7 +1250,7 @@ def init(
12501250

12511251
tracker.add("precheck", "Check required tools")
12521252
tracker.complete("precheck", "ok")
1253-
tracker.add("ai-select", "Select AI assistant")
1253+
tracker.add("ai-select", "Select coding agent integration")
12541254
tracker.complete("ai-select", f"{selected_ai}")
12551255
tracker.add("script-select", "Select script type")
12561256
tracker.complete("script-select", selected_script)
@@ -1565,7 +1565,7 @@ def _display_cmd(name: str) -> str:
15651565
return f"/speckit-{name}"
15661566
return f"/speckit.{name}"
15671567

1568-
steps_lines.append(f"{step_num}. Start using {usage_label} with your AI agent:")
1568+
steps_lines.append(f"{step_num}. Start using {usage_label} with your coding agent:")
15691569

15701570
steps_lines.append(f" {step_num}.1 [cyan]{_display_cmd('constitution')}[/] - Establish project principles")
15711571
steps_lines.append(f" {step_num}.2 [cyan]{_display_cmd('specify')}[/] - Create baseline specification")
@@ -1636,7 +1636,7 @@ def check():
16361636
console.print("[dim]Tip: Install git for repository management[/dim]")
16371637

16381638
if not any(agent_results.values()):
1639-
console.print("[dim]Tip: Install an AI assistant for the best experience[/dim]")
1639+
console.print("[dim]Tip: Install a coding agent for the best experience[/dim]")
16401640

16411641
@app.command()
16421642
def version():
@@ -1882,7 +1882,7 @@ def get_speckit_version() -> str:
18821882

18831883
integration_app = typer.Typer(
18841884
name="integration",
1885-
help="Manage AI agent integrations",
1885+
help="Manage coding agent integrations",
18861886
add_completion=False,
18871887
)
18881888
app.add_typer(integration_app, name="integration")
@@ -2020,7 +2020,7 @@ def integration_list(
20202020
console.print(table)
20212021
return
20222022

2023-
table = Table(title="AI Agent Integrations")
2023+
table = Table(title="Coding Agent Integrations")
20242024
table.add_column("Key", style="cyan")
20252025
table.add_column("Name")
20262026
table.add_column("Status")

0 commit comments

Comments
 (0)