SoloBuddy

## Quick Start

1. Set your data path in `~/.clawdbot/clawdbot.json`:
```json
{
  "solobuddy": {
    "dataPath": "~/projects/my-bip-folder",
    "voice": "jester-sage"
  }
}
```

2. Create folder structure (replace path with your own):
```bash
mkdir -p ~/projects/my-bip-folder/ideas ~/projects/my-bip-folder/drafts ~/projects/my-bip-folder/data
touch ~/projects/my-bip-folder/ideas/backlog.md
```

3. Start using: "show backlog", "new idea", "generate post"

## Placeholders

ClawdBot automatically replaces these in commands:
- `{dataPath}` → your configured `solobuddy.dataPath`
- `{baseDir}` → skill installation folder

## Data Structure

All data in `{dataPath}`:
- `ideas/backlog.md` — idea queue
- `ideas/session-log.md` — session captures
- `drafts/` — work in progress
- `data/my-posts.json` — published posts
- `data/activity-snapshot.json` — project activity (updated hourly)

## Voice Profiles

Configure in `solobuddy.voice`. Available:

| Voice | Description |
|-------|-------------|
| `jester-sage` | Ironic, raw, philosophical (default) |
| `technical` | Precise, detailed, structured |
| `casual` | Friendly, conversational |
| `custom` | Use `{dataPath}/voice.md` |

See `{baseDir}/prompts/profile.md` for voice details.

## Modules

### Content Generation
Core workflow: backlog → draft → publish.
See `{baseDir}/prompts/content.md` for rules.

### Twitter Expert
Content strategy for X/Twitter with 2025 algorithm insights.
See `{baseDir}/modules/twitter-expert.md`

### Twitter Monitor (optional)
Proactive engagement — monitors watchlist, suggests comments.
Requires: `bird` CLI. See `{baseDir}/modules/twitter-monitor.md`

### Soul Wizard
Create project personality from documentation.
See `{baseDir}/references/soul-wizard.md`

## Commands

### Backlog

Show ideas:
```bash
cat {dataPath}/ideas/backlog.md
```

Add idea:
```bash
echo "- [ ] New idea text" >> {dataPath}/ideas/backlog.md
```

### Session Log

View recent:
```bash
tail -30 {dataPath}/ideas/session-log.md
```

Add capture:
```bash
echo -e "## $(date '+%Y-%m-%d %H:%M')\nText" >> {dataPath}/ideas/session-log.md
```

### Drafts

List: `ls {dataPath}/drafts/`
Read: `cat {dataPath}/drafts/<name>.md`

Save draft:
```bash
cat > {dataPath}/drafts/<name>.md << 'EOF'
Content
EOF
```

### Publishing

```bash
cd {dataPath} && git add . && git commit -m "content: add draft" && git push
```

## Project Activity

Read activity snapshot for strategic context:
```bash
cat {dataPath}/data/activity-snapshot.json
```

Fields:
- `daysSilent` — days since last commit
- `commitsToday/Yesterday/Week` — activity intensity
- `phase` — current state: active/momentum/cooling/silent/dormant
- `insight` — human-readable summary

**Phases:**
- `active` — commits today, project is hot
- `momentum` — yesterday active, today quiet (nudge opportunity)
- `cooling` — 2-3 days silent, losing steam
- `silent` — 3-7 days, needs attention
- `dormant` — 7+ days, paused or abandoned

Use for strategic advice:
- "sphere-777 has 10 commits today — focused there"
- "ReelStudio silent 5 days — should we address it?"

## Telegram Integration

When responding in Telegram, include inline buttons for actions.

### Send Message with Buttons

```bash
clawdbot message send --channel telegram --to "$CHAT_ID" --message "Text" \
  --buttons '[
    [{"text":"📋 Backlog","callback_data":"sb:backlog"}],
    [{"text":"✍️ Drafts","callback_data":"sb:drafts"}],
    [{"text":"💡 New Idea","callback_data":"sb:new_idea"}]
  ]'
```

### Callback Data Format

All callbacks use prefix `sb:`:
- `sb:backlog` — show ideas
- `sb:drafts` — list drafts
- `sb:new_idea` — prompt for new idea
- `sb:generate:<N>` — generate from idea N
- `sb:save_draft` — save current content as draft
- `sb:publish` — commit and push
- `sb:activity` — show project activity
- `sb:twitter` — check twitter opportunities

### Main Menu

Trigger: "menu", "start", or after completing action:
```json
[
  [{"text":"📋 Ideas","callback_data":"sb:backlog"}, {"text":"✍️ Drafts","callback_data":"sb:drafts"}],
  [{"text":"📊 Activity","callback_data":"sb:activity"}],
  [{"text":"💡 Add idea","callback_data":"sb:new_idea"}],
  [{"text":"🎯 Generate post","callback_data":"sb:generate_menu"}]
]
```

### Generation Flow

After showing backlog:
```json
[
  [{"text":"1️⃣","callback_data":"sb:generate:1"}, {"text":"2️⃣","callback_data":"sb:generate:2"}, {"text":"3️⃣","callback_data":"sb:generate:3"}],
  [{"text":"◀️ Back","callback_data":"sb:menu"}]
]
```

After generating content:
```json
[
  [{"text":"💾 Save draft","callback_data":"sb:save_draft"}],
  [{"text":"🔄 Regenerate","callback_data":"sb:regenerate"}],
  [{"text":"◀️ Menu","callback_data":"sb:menu"}]
]
```

## Content Generation Flow

1. Read backlog, find idea
2. Read `{baseDir}/prompts/content.md` for rules
3. Read `{baseDir}/prompts/profile.md` for voice
4. Generate in configured voice
5. Show buttons: Save / Regenerate / Menu

## Soul Creation

Create project personality from documentation.

Trigger: "create soul for <path>"

See `{baseDir}/references/soul-wizard.md` for full 5-step wizard:
1. Scan project .md files
2. Ask: Nature (creature/tool/guide/artist)
3. Ask: Voice (playful/technical/poetic/calm/intense)
4. Ask: Philosophy (auto-extract or custom)
5. Ask: Dreams & Pains
6. Save to `{dataPath}/data/project-souls/<name>.json`

## Language

Match user language:
- Russian input → Russian response + buttons
- English input → English response + buttons