Files

Jason Woltje 9ccd13fae7 feat: add USER.md and TOOLS.md to bootstrap framework

Introduce user profile (USER.md) and machine tool reference (TOOLS.md)
as first-class framework files. Both ship as generic defaults and are
personalized via mosaic init.

- Add USER.md/TOOLS.md defaults and parameterized templates
- Update AGENTS.md load order (6 → 8 steps)
- Update SOUL.md: default name "Assistant", add trash/mental-notes guardrails
- Update install.sh: preserve USER.md/TOOLS.md on reinstall
- Update mosaic-init: interactive USER.md + TOOLS.md generation
- Update mosaic-doctor: existence checks for new files
- Update mosaic launcher: inject USER.md/TOOLS.md into runtime prompt
- Update README: architecture diagram, generic-repo policy note

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-21 11:36:16 -06:00

1.6 KiB

Raw Blame History

Machine-Level Tool Reference

Centralized reference for tools, credentials, and CLI patterns available across all projects. Project-specific tooling belongs in the project's AGENTS.md, not here.

Mosaic Git Wrappers (Use First)

Mosaic wrappers at ~/.config/mosaic/rails/git/*.sh handle platform detection and edge cases. Always use these before raw CLI commands.

# Issues
~/.config/mosaic/rails/git/issue-create.sh
~/.config/mosaic/rails/git/issue-close.sh

# PRs
~/.config/mosaic/rails/git/pr-create.sh
~/.config/mosaic/rails/git/pr-merge.sh

# Milestones
~/.config/mosaic/rails/git/milestone-create.sh

# CI queue guard (required before push/merge)
~/.config/mosaic/rails/git/ci-queue-wait.sh --purpose push|merge

Code Review (Codex)

# Code quality review
~/.config/mosaic/rails/codex/codex-code-review.sh --uncommitted

# Security review
~/.config/mosaic/rails/codex/codex-security-review.sh --uncommitted

Git Providers

Instance	URL	CLI	Purpose
(add your git providers here)

Credentials

Location: (configure your credential file path)

Never expose actual values. Never commit credential files.

CLI Gotchas

(Add platform-specific CLI gotchas as you discover them. Examples: TTY requirements, default list limits, API fallback patterns.)

Custom Tools

(Add any machine-specific tools, scripts, or workflows here.)

Safety Defaults

Prefer trash over rm when available — recoverable beats gone forever
Never run destructive commands without explicit instruction
Write it down — "mental notes" don't survive session restarts; files do

1.6 KiB Raw Blame History