Skip to content

Commit 09c4cd4

Browse files
docs: fix inaccuracies in troubleshooting docs
- Fix Claude Code installation instructions (not an npm package) - Correct default max-iterations from 100 to 10 - Update "Why Chief?" to reference Chief Wiggum - Remove outdated model default mention - Remove reference to non-existent PRD settings - Clarify Claude Pro/API requirements
1 parent fa5f993 commit 09c4cd4

2 files changed

Lines changed: 7 additions & 12 deletions

File tree

docs/troubleshooting/common-issues.md

Lines changed: 3 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -18,15 +18,10 @@ Error: Claude Code CLI not found. Please install it first.
1818

1919
**Solution:**
2020

21-
```bash
22-
# Install Claude Code
23-
npm install -g @anthropic-ai/claude-code
21+
Install Claude Code following the [official instructions](https://docs.anthropic.com/en/docs/claude-code/getting-started), then verify:
2422

25-
# Verify installation
23+
```bash
2624
claude --version
27-
28-
# If using a custom node installation, ensure it's in PATH
29-
export PATH="$HOME/.npm-global/bin:$PATH"
3025
```
3126

3227
## Permission Denied
@@ -107,7 +102,7 @@ chief --no-sound
107102

108103
**Symptom:** Chief stops with "max iterations reached" message.
109104

110-
**Cause:** Claude hasn't completed after the iteration limit (default 100).
105+
**Cause:** Claude hasn't completed after the iteration limit (default 10).
111106

112107
**Solution:**
113108

docs/troubleshooting/faq.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,15 +14,15 @@ Chief is an autonomous PRD agent. You write a Product Requirements Document with
1414

1515
### Why "Chief"?
1616

17-
Chief manages the project. You write the requirements, Chief orchestrates the work.
17+
Named after Chief Wiggum from The Simpsons (Ralph Wiggum's dad). Chief orchestrates the [Ralph loop](https://ghuntley.com/ralph/).
1818

1919
### Is Chief free?
2020

21-
Chief itself is open source and free. However, it uses Claude Code, which requires an Anthropic API subscription.
21+
Chief itself is open source and free. However, it uses Claude Code, which requires a Claude Pro subscription or Anthropic API access.
2222

2323
### What models does Chief use?
2424

25-
Chief uses whatever model is configured in Claude Code. By default, this is Claude 3 Sonnet.
25+
Chief uses whatever model is configured in Claude Code.
2626

2727
## Usage
2828

@@ -112,7 +112,7 @@ Yes. Chief doesn't know or care what language you're using. It passes your PRD t
112112

113113
### How does Chief handle tests?
114114

115-
Chief instructs Claude to run quality checks (tests, lint, typecheck) before committing. The specific commands come from your PRD's settings or Claude's inference from your codebase.
115+
Chief instructs Claude to run quality checks (tests, lint, typecheck) before committing. Claude infers the appropriate commands from your codebase (e.g., `npm test`, `pytest`).
116116

117117
## Troubleshooting
118118

0 commit comments

Comments
 (0)