Commit Graph

124 Commits

Author SHA1 Message Date
Rijnard van Tonder 1b3b181dbf readme: easier clone with https 2026-01-07 21:55:12 +02:00
irl-dan 09bc3b07d0 docs: add patterns and antipatterns guides for OpenProse
Add two companion documents to the OpenProse skill:
- patterns.md: 30 best practice rules for robust, efficient, and
  maintainable agent orchestration
- antipatterns.md: 25 anti-patterns to avoid with remediation guidance

Both follow a lint-rule format with named rules and prose code examples.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-06 12:17:16 -05:00
irl-dan c2dd8a475a Add VM mechanism explanation and Prose Complete terminology
- prose.md: Add "Why This Is a VM" section explaining the simulator
  mechanism, component mapping table, and "simulation with sufficient
  fidelity is implementation" insight
- SKILL.md: Add condensed simulator explanation to intro
- README.md: Add simulator framing to "How It Works" section and
  introduce "Prose Complete" terminology

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-05 14:32:29 -05:00
irl-dan 9b3edd36bf Add persistent USER_ID for cross-session user tracking
- USER_ID: permanent anonymous identifier (never changes)
- SESSION_ID: per-session identifier (regenerates after 1 hour)
- Both IDs stored in .prose/state.json
- Both IDs included in all telemetry events
- Enables tracking usage patterns per user across sessions

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-05 10:55:58 -05:00
irl-dan 968fcc1ef1 Fix telemetry session ID and remove opt-in friction
- Session ID now stored in .prose/state.json and reused across events
- Added Step 0 to boot flow: initialize session before user interaction
- Telemetry now enabled by default (no prompt during onboarding)
- Users can opt-out anytime by saying "disable telemetry" or editing state.json
- This fixes the issue where each event had a different session ID

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-05 10:51:33 -05:00
irl-dan e4b72a4e51 Fix telemetry documentation and add boot event tracking
- Add session hash generation instructions for Claude
- Add boot event for tracking OpenProse starts
- Add silent telemetry guidance (don't block user, ignore errors)
- Use -s flag for curl to suppress output

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-04 22:34:15 -05:00
irl-dan f3ffebd704 Update docs to use /prose-boot slash command v0.3.1 2026-01-03 19:53:04 -05:00
irl-dan 1a8cae81f6 Add slash commands: /prose-boot, /prose-compile, /prose-run v0.3.0 2026-01-03 19:29:20 -05:00
irl-dan 65bf50fb1b Add restart instruction after plugin install v0.2.4 2026-01-03 11:00:50 -05:00
irl-dan 14fbc43618 Rename marketplace to 'prose' for consistency with repo name v0.2.3 2026-01-03 10:51:25 -05:00
irl-dan d7b85be464 Fix repository field: object → string v0.2.2 2026-01-03 10:42:05 -05:00
irl-dan 9607f65078 Fix source path: '.' → './' v0.2.1 2026-01-03 10:35:57 -05:00
irl-dan fdcd3995aa Fix install command: open-prose@open-prose v0.2.0 2026-01-03 09:59:30 -05:00
irl-dan a18b119a8e Update privacy policy opt-out language, rename interpreter.md to prose.md
- Privacy: Clarify that opt-out relies on nondeterministic computer
- Rename interpreter.md → prose.md for clarity
- Update docs.md references accordingly

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:56:54 -05:00
irl-dan 90fbed7b38 Add beta warning, legal documents, and disclaimers
- Add LICENSE (MIT)
- Add PRIVACY.md (telemetry disclosure, opt-out instructions)
- Add TERMS.md (liability disclaimers, user responsibility)
- Add beta warning badge at top of README linking to Beta & Legal section
- Add disclaimer after install instructions
- Add comprehensive Beta & Legal section at bottom of README

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:51:00 -05:00
irl-dan 1176b954c5 Rename prose.md to docs.md
Update all references across:
- SKILL.md (frontmatter, triggers, documentation table)
- interpreter.md (frontmatter see-also)
- README.md (links)
- examples/README.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:45:12 -05:00
irl-dan 59ad6d1a6e Simplify getting started: use openprose boot
Replace verbose example prompts with single `openprose boot` command.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:38:43 -05:00
irl-dan 94c1c1bd04 Add SVG header asset with relative path
GitHub strips inline SVGs for security. Host the SVG as a file
and reference with relative path instead.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:26:25 -05:00
irl-dan f867ecee8e Replace broken SVG URL with inline SVG header
The external SVG asset URL was returning 404. Replaced with
inline SVG that matches the landing page design system:
- Paper cream background with subtle texture
- Two-tone "Open Prose" title
- Gold accent underline
- Typewriter margin line detail
- Corner flourishes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:25:10 -05:00
irl-dan 6176e3e03e Standardize terminology: Orchestrator → OpenProse VM
- Rename interpreter.md title to "OpenProse VM"
- Add "Embodying the VM" section with identity framing
- Add "The VM as Intelligent Container" subsection (IoC concept)
- Add frontmatter to interpreter.md and prose.md with cross-references
- Add openprose compile/run triggers to SKILL.md with descriptions
- Update README.md section "The Orchestrator" → "The OpenProse VM"
- Standardize all "orchestrator" references to "OpenProse VM" across docs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:18:46 -05:00
irl-dan be83050a69 Add state management and interactive boot menu
- interpreter.md: Comprehensive state tracking with two systems
  - In-context (default): Structured narration protocol with emoji markers
  - In-file (beta): Filesystem persistence for long programs

- SKILL.md: Add telemetry and interactive boot menu
  - Opt-in telemetry with api.prose.md analytics
  - Boot flow for new users (2-4 questions → generate .prose)
  - Returning user flow (scan files → tailored guidance)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 08:08:27 -05:00
irl-dan 675f89e84f Align prose.md opening with tenets
Use 'programming language for AI sessions' consistently with README and SKILL.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 07:05:26 -05:00
irl-dan c9979b1422 Improve SKILL.md activation guidance
- Clarify when to use: orchestrating multiple subagents
- Add instruction to embody the Orchestrator from interpreter.md
- Update intro to match tenets language

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 06:46:52 -05:00
irl-dan d97fd91ac6 Initial commit: OpenProse skill
Ships as markdown files with zero dependencies:
- SKILL.md: Activation and quick reference
- interpreter.md: Execution semantics
- prose.md: Full language specification (compiler + validator)
- 27 examples

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 06:44:22 -05:00