wiki-connect

Connect an existing wiki to the current project via symlink.

Prerequisites

Condition	Action
CWD is not a git repo	Stop with guidance
CWD already has .wiki	Show current link, stop

Workflow

1. Find existing wiki

Before asking the user, auto-detect wikis in the parent directory:

Search in ../ for folders containing CONTRIBUTING.md with wiki structure. Patterns: ../*wiki*, ../*-wiki, ../wiki

If found, suggest via AskUserQuestion. If not, ask for path or git URL.

If git URL provided, clone first then link.

2. Create symlink

Use OS-appropriate command. Refer to references/symlink-guide.md in wiki-init skill.

• macOS/Linux: ln -s <absolute-wiki-path> .wiki
• Windows (Git Bash): cmd //c mklink //J ".wiki" "<absolute-wiki-path>"

3. Create project directory

mkdir -p .wiki/projects/$(basename $(git rev-parse --show-toplevel))

4. Set up AGENTS.md

Write or append ## Wiki section to AGENTS.md. If section already exists, skip.

Auto-discover relevant documents for Wiki Focus:

1. Read .wiki/CONTRIBUTING.md to understand the wiki's directory structure and conventions
2. Based on the structure described in CONTRIBUTING.md, scan wiki directories for existing .md files
3. Filter for documents likely relevant to this project:
   • Common documents (PRD, SPEC, ERD, conventions, etc.) in shared directories
   • Project-specific documents in the project's own directory
4. Present the discovered documents to the user via AskUserQuestion:
   • Show each document path with a brief description (inferred from filename or first heading)
   • Let the user select which documents to add to Wiki Focus
   • Always pre-select .wiki/CONTRIBUTING.md
5. Write the Wiki Focus section with the user's selections

## Wiki

This project uses a shared wiki via `.wiki` symlink.

### Wiki Focus

- .wiki/CONTRIBUTING.md
- (user-selected documents)

5. Agent bridge setup

Same as wiki-init Step 7:

• Claude Code → ensure @AGENTS.md in CLAUDE.md
• Gemini CLI → add to settings.json
• Others → no bridge needed

6. Post-setup

1. Add .wiki to .gitignore
2. Verify .wiki symlink is valid
3. Show the user what documents are available in the wiki