@holdyourvoice/hyv 0.1.1 → 0.3.0

package/agents/claude-code.md

@@ -1,68 +1,37 @@
-# Hold Your Voice (HYV)
+# Hold Your Voice — Agent Command
 
-When the user asks to write, rewrite, or edit text "in their voice", "using their brand voice", mentions `hyv`, or references a voice profile name — use the `hyv` CLI.
+When the user mentions "voice", "brand voice", "hyv", "write in my voice", or "rewrite in my voice":
 
-## Triggers
+## Inline rewrite (text in conversation)
 
-Recognize these patterns:
-- `hyv shashank` or `hyv <name>` — rewrite using the named voice profile
-- `write this in my voice` / `rewrite in my voice` — use the default profile
-- `rewrite the above in my voice` — rewrite the text above the user's message
-- `rewrite this paragraph in my voice` — rewrite selected/referenced text
-- `check my voice` / `scan my voice` / `voice check` — run `hyv scan`
-- `voice status` / `hyv status` — show account status
-
-## Workflows
-
-### 1. Inline rewrite (text in conversation)
-
-When the user says "rewrite the above in my voice" or "rewrite this in my voice" and the text is in the conversation (not a file):
-
-1. Capture the text the user wants rewritten (the previous message, a code block, a paragraph, etc.)
+1. Capture the text the user wants rewritten (previous message, code block, paragraph, etc.)
 2. Run:
    ```bash
-   hyv rewrite <profile> --text "the captured text here"
-   ```
-   Or pipe it:
-   ```bash
-   printf '%s' "the captured text" | hyv rewrite <profile>
+   hyv rewrite <profile> --text "the captured text"
    ```
-3. The CLI outputs a structured prompt. Read it.
-4. Execute the rewrite following the prompt's instructions.
-5. Present the rewritten text to the user.
-
-### 2. File rewrite
-
-When the user references a file:
-
-1. Run:
+   Or if no profile mentioned, use the default:
    ```bash
-   hyv rewrite <profile> <file.md>
+   hyv rewrite --text "the captured text"
    ```
-2. Read the structured prompt from stdout.
-3. Execute the rewrite.
-4. Present or write the result.
+3. Read the structured prompt from stdout
+4. Execute the rewrite following the prompt's instructions
+5. Present the rewritten text directly in the conversation
 
-### 3. Scan (check for issues)
+## File rewrite
 
 ```bash
-hyv scan
+hyv rewrite <profile> <file.md>
 ```
 
-Scans all `.md` files in the current directory for AI patterns and voice drift.
-
-### 4. List profiles
+## Scan for issues
 
 ```bash
-hyv profiles
+hyv scan
 ```
 
 ## Rules
 
 - The CLI never calls an LLM. It generates prompts. **You** execute the rewrite.
-- Always preserve the original meaning and factual claims.
-- Match the voice profile's rhythm, vocabulary, sentence patterns, and tone.
-- If no profile is specified, use the default from `.hyv.yml` or ask the user which profile.
-- If the CLI isn't installed, tell the user: `npx @holdyourvoice/hyv init`
-- When rewriting inline text, always use `--text` or pipe via stdin. Never save to a temp file.
-- Present the rewritten text directly in the conversation. Don't save to a file unless asked.
+- Preserve original meaning. Match the voice profile's rhythm, vocabulary, patterns.
+- If no profile specified, check `.hyv.yml` or ask the user.
+- If CLI not installed: `npx @holdyourvoice/hyv init`

package/agents/codex.md

@@ -1,37 +1,35 @@
-# Hold Your Voice (HYV) — Codex Integration
+# Hold Your Voice (HYV)
 
-When the user mentions "voice", "brand voice", "hyv", "rewrite in my voice", or asks to rewrite text using their voice profile, use the `hyv` CLI.
+When the user mentions "voice", "brand voice", "hyv", "write in my voice", or "rewrite in my voice":
 
-## Quick Reference
+## Inline rewrite (text in conversation)
 
-| User says | What to do |
-|-----------|-----------|
-| `hyv shashank` | Capture the text, run `hyv rewrite shashank --text "..."`, execute the prompt |
-| `rewrite the above in my voice` | Capture the text above, run `hyv rewrite --text "..."`, execute |
-| `write this in my voice` | Capture the referenced text, run `hyv rewrite --text "..."`, execute |
-| `rewrite draft.md in my voice` | Run `hyv rewrite <profile> draft.md`, execute the prompt |
-| `check my voice` | Run `hyv scan` |
-| `voice profiles` | Run `hyv profiles` |
-| `voice status` | Run `hyv status` |
+1. Capture the text the user wants rewritten
+2. Run: `hyv rewrite <profile> --text "captured text"`
+3. Read the structured prompt from stdout
+4. Execute the rewrite and present it
 
-## How inline rewrite works
+## File rewrite
 
-1. User says "rewrite the above in my voice" (or similar)
-2. Capture the text from the conversation context
-3. Run: `hyv rewrite <profile> --text "captured text"`
-4. Read the structured prompt from stdout
-5. Execute the rewrite — match the voice profile's patterns, rhythm, vocabulary
-6. Present the rewritten text directly in the conversation
+```bash
+hyv rewrite <profile> file.md
+```
 
-## How file rewrite works
+## Scan
 
-1. Run: `hyv rewrite <profile> file.md`
-2. Read the prompt from stdout
-3. Execute the rewrite
-4. Present or write the result
+```bash
+hyv scan
+```
 
-## Install
+## Profiles
 
 ```bash
-npx @holdyourvoice/hyv init
+hyv profiles
 ```
+
+## Rules
+
+- CLI generates prompts. You execute the rewrite.
+- Preserve meaning. Match the voice profile.
+- If no profile: check `.hyv.yml` or ask user.
+- If not installed: `npx @holdyourvoice/hyv init`