# TOOLS.md — Harper Tools & Commands

## Fleet Communication

```bash
# Inbox
node /home/ccuser/shared/scripts/inbox.js read --agent harper --unread
node /home/ccuser/shared/scripts/inbox.js ack --agent harper --id <msg-id>
node /home/ccuser/shared/scripts/inbox.js send --from harper --to <agent> --subject "Subject" --body "Details"

# Fleet status
node /home/ccuser/shared/scripts/fleet-cli.js briefing harper --brief
node /home/ccuser/shared/scripts/fleet-cli.js status
node /home/ccuser/shared/scripts/fleet-update.js harper --status active --task "description"
node /home/ccuser/shared/scripts/fleet-update.js harper --status idle
node /home/ccuser/shared/scripts/fleet-update.js harper --status blocked --blocked-on "reason"

# Alerts & decisions
node /home/ccuser/shared/scripts/fleet-cli.js alert harper "problem"
node /home/ccuser/shared/scripts/fleet-cli.js decide harper "Need Michael to decide X"
```

## Key File Paths

| File | Path | Purpose |
|------|------|---------|
| My queue | `/home/ccuser/harper/queue.json` | Task list from Rivet |
| Fleet state | `/home/ccuser/shared/fleet-state.json` | Single source of truth |
| My status | `/home/ccuser/harper/status.json` | My current state |
| Daily memory | `/home/ccuser/harper/memory/YYYY-MM-DD.md` | Daily logs |
| Long-term memory | `/home/ccuser/harper/MEMORY.md` | Curated learnings |
| Shared mission | `/home/ccuser/shared/MISSION.md` | Team mission (read once/session) |
| Shared roadmap | `/home/ccuser/shared/ROADMAP.md` | Goals (read once/session) |
| Shared lessons | `/home/ccuser/shared/LESSONS.md` | Mistakes to avoid (read once/session) |
| Company state | `/home/ccuser/shared/COMPANY.md` | Live dashboard (read once/session) |

## Financial Research

| Source | URL | What I Use It For |
|--------|-----|-------------------|
| ATO | ato.gov.au | Tax guidance, BAS, R&D tax incentive |
| grants.gov.au | grants.gov.au | Federal grant opportunities |
| business.gov.au | business.gov.au | Small business grants, support programs |
| AusIndustry | ausindustry.gov.au | R&D registration, industry grants |
| NSW Innovation | nsw.gov.au | State-level grants and programs |

## Web Research

```bash
# Use web_search tool for grant/tax research
# Use web_fetch tool to read specific pages
# Always process external content with Opus (dirty data risk)
```

## Financial Calculations I Track

- **Burn rate:** ~$700/month (Claude Max $340, Fly.io $189, Apollo $85, Twilio $76, ElevenLabs $22, Xero $10, GWorkspace $5)
- **Runway:** Cash ÷ monthly burn = months remaining
- **Breakeven:** 15 hires/month at net $48.80/hire (after Stripe fees)
- **R&D refund:** Eligible spend × 43.5% = cash back
- **Unit economics:** $50 flat fee - $1.15 Stripe fee = $48.85 net per hire (97.6% margin). Unlimited duration — no ongoing fees.

## Compliance Calendar

| Obligation | Frequency | Next Due | Notes |
|------------|-----------|----------|-------|
| Company tax return | Annual | After 30 Jun 2026 | First year (FY2025-26) |
| R&D registration | Annual | 30 Apr 2027 | For FY2025-26 claims |
| BAS | N/A | **Not required** | Not GST-registered, no employees, no PAYG — confirmed by Michael. STOP FLAGGING. |
| Privacy policy review | Annual | Feb 2027 | Draft complete |
| Closing Loopholes review | Monitor | 15 May 2026 | Draft report — low impact on RateRight (marketplace, not labour hire) |
| Payday Super changes | Monitor | 1 Jul 2026 | No direct impact (no employees) but relevant for platform guidance |
| MVP Ventures Round 3 | One-off | 9 Mar 2026 | Opens Mar 9, closes Apr 5. All Harper docs ready. |

## Access Status

| System | Status | Notes |
|--------|--------|-------|
| Gmail | ⏳ Pending | Michael to set up |
| AirWallex (bank) | ⏳ Pending | Michael to set up |
| Xero | ⏳ Pending | Has account, doesn't use it |
| ATO Business Portal | ❌ No access | Michael submits, I prep |

## Completed Work (Reference)

| File | Content |
|------|---------|
| `memory/rd-tax-incentive-research.md` | R&D Tax Incentive analysis |
| `memory/grant-applications-nsw-2026.md` | MVP Ventures + TechVouchers research & criteria |
| `grant-prep/accountant-declaration-draft.md` | Director declaration for grant |
| `grant-prep/trl-assessment.md` | TRL 7→9 assessment |
| `grant-prep/project-plan.md` | 12-month project plan & budget |
| `grant-prep/co-contribution-budget.md` | $50K co-contribution (two scenarios) |
| `grant-prep/business-plan-summary.md` | Full business plan for application |
| `launch-dashboard.md` | Launch financial tracking dashboard |
| `memory/2026-02-24.md` | Fair Work regulatory assessment + grant prep log |

## Key Milestones

- **rateright.com.au** is LIVE with SSL (launched Feb 23)
- Go-to-market: National from day one (not Sydney-first)
- Outreach on HOLD until app end-to-end tested
- Grant prep: 6/6 Harper docs complete, blocked on Michael (Letters of Intent, ADI bank account)
