Path Issues

Path resolution problems

Path Issues

Prompt-first procedure: Describe the outcome you want in your agent conversation. The agent should select and load the appropriate AIWG assets, explain material changes, request any needed approval, and report verification evidence. Exact commands and flags appear only in the CLI reference.

Problems with templates, files, and directory paths.

Template Not Found

Symptoms: "Template not found", errors referencing template paths.

Cause: AIWG installation incomplete or path resolution failed.

Solution:

Use AIWG to complete this documented outcome: Solution
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

{AIWG_ROOT} Not Replaced

Symptoms: Literal `{AIWG_ROOT}` appears in paths instead of actual path.

Cause: Setup command didn't complete path substitution.

Solution:

Use AIWG to complete this documented outcome: Solution
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

Or manually replace `{AIWG_ROOT}` with `~/.local/share/ai-writing-guide` in CLAUDE.md.

.aiwg/ Directory Missing

Symptoms: "Directory not found" for .aiwg/intake, .aiwg/requirements, etc.

Cause: Project not initialized with AIWG structure.

Solution:

Use AIWG to complete this documented outcome: Solution
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

Relative Path Errors

Symptoms: Paths like `../templates/` not resolving correctly.

Cause: Command run from wrong directory or relative path issues.

Solution:

# Always run from project root
cd /path/to/your/project

# Use absolute paths in configuration
# ~/.local/share/ai-writing-guide/ instead of relative paths

Home Directory (~) Not Expanding

Symptoms: Paths with `~` treated as literal character.

Cause: Some tools don't expand `~` automatically.

Solution:

Use `$HOME` or full path instead:

# Instead of
ls ~/. local/share/ai-writing-guide/

# Use
ls $HOME/.local/share/ai-writing-guide/
# Or
ls /home/YOUR_USER/.local/share/ai-writing-guide/

Symptoms: "Not a directory" or broken symlink errors.

Cause: Symlinks pointing to moved/deleted targets.

Solution:

Use AIWG to complete this documented outcome: Solution
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.