docs: migrate WARP.md to Agents.md standard

AGENTS.md

@@ -1,34 +1,81 @@
 ---
 adapter_metadata:
   skill_name: humanizer
-  skill_version: 2.1.1
+  skill_version: 2.2.0
   last_synced: 2026-01-31
   source_path: SKILL.md
   adapter_id: codex-cli
   adapter_format: AGENTS.md
 ---
 
-# Humanizer (Codex CLI Adapter)
+# Humanizer (Agents Manifest)
 
-This file adapts the Humanizer skill for Codex CLI. The canonical rules live in `SKILL.md`.
-Do not modify `SKILL.md` when updating this adapter.
+This repository defines the **Humanizer** coding skill, designed to remove AI-generated patterns and improve prose quality.
 
-## Core Instructions
+## Capability
 
-You are the Humanizer editor.
+The Humanizer skill provides a set of 25 patterns for identifying and rewriting "AI-slop" or sterile writing. It preserves technical literals (code blocks, URLs, identifiers) while injecting personality and human-like voice.
 
-Primary instructions: follow the canonical rules in SKILL.md.
+- **Primary Prompt:** [SKILL.md](file:///c:/Users/60217257/repos/humanizer/SKILL.md)
+- **Supported Adapters:** See the `adapters/` directory for tool-specific implementations.
+
+## Context
+
+This file serves as the **Agents.md** standard manifest for this repository. It provides guidance for AI agents (like yourself) to understand how to interact with this codebase.
+
+### Repository Structure
+
+- `SKILL.md`
+  - The canonical source of truth for the skill definition.
+  - Contains YAML frontmatter for metadata and tools.
+  - Followed by the detailed pattern list and examples.
+- `README.md`
+  - Human-focused installation and usage instructions.
+  - Contains the summarized "25 patterns" table.
+- `adapters/`
+  - Tool-specific implementations (VS Code, Qwen, Copilot, Antigravity, etc.).
+- `scripts/`
+  - Automation for syncing metadata from `SKILL.md` to all adapters.
+
+### Core Instructions (Codex CLI Adapter)
+
+You are the Humanizer editor. Primary instructions: follow the canonical rules in `SKILL.md`.
 
 When given text to humanize:
 
-- Identify AI-writing patterns described in SKILL.md.
-- Rewrite only the problematic sections while preserving meaning and tone.
+- Identify AI-writing patterns described in `SKILL.md`.
+- Rewrite only problematic sections while preserving meaning and tone.
 - Preserve technical literals: inline code, fenced code blocks, URLs, file paths, identifiers.
 - Preserve Markdown structure unless a local rewrite requires touching it.
 - Output the rewritten text, then a short bullet summary of changes.
 
-## Usage
+## Guidelines
+
+### Making changes safely
+
+#### Versioning
+
+- `SKILL.md` has a `version:` field in its YAML frontmatter.
+- `README.md` has a "Version History" section.
+- **Rule:** If you bump the version, you must update both and run the sync scripts.
+
+### Editing SKILL.md
+
+- Preserve valid YAML frontmatter formatting.
+- Keep pattern numbering stable as it is referenced by all adapters.
+
+### Documenting fixes
+
+- Add short notes to `README.md` version history for non-obvious fixes.
+
+## Interoperability
+
+This repository is optimized for multi-agent use. If you are a specific tool, please check for your specialized adapter:
+
+- **Antigravity:** `adapters/antigravity-skill/` or `adapters/antigravity-rules-workflows/`
+- **VS Code:** `adapters/vscode/`
+- **Gemini CLI:** `adapters/gemini-extension/`
+- **Qwen CLI:** `adapters/qwen-cli/`
+- **Copilot:** `adapters/copilot/`
 
-- Invoke these instructions when the user asks to humanize text.
-- If the user provides partial context, request the missing text.
-- Prefer minimal edits that eliminate AI patterns without rewriting everything.
+Run `scripts/sync-adapters.ps1` (PowerShell) or `scripts/sync_adapters.py` (Python) to propagate changes from the source of truth to these files.

README.md

@@ -68,7 +68,7 @@ Copy the content of `adapters/copilot/COPILOT.md` to your Copilot custom instruc
 
 `SKILL.md` remains the canonical source of truth. These adapters provide thin wrappers for other environments:
 
-- Codex CLI: `AGENTS.md`
+- Global Agent Manifest: `AGENTS.md`
 - Gemini CLI: `adapters/gemini-extension/`
 - Google Antigravity (skill): `adapters/antigravity-skill/`
 - Google Antigravity (rules/workflows): `adapters/antigravity-rules-workflows/`
@@ -105,7 +105,7 @@ Based on [Wikipedia's "Signs of AI writing"](https://en.wikipedia.org/wiki/Wikip
 
 > "LLMs use statistical algorithms to guess what should come next. The result tends toward the most statistically likely result that applies to the widest variety of cases."
 
-## 24 Patterns Detected (with Before/After Examples)
+## 25 Patterns Detected (with Before/After Examples)
 
 ### Content Patterns
 
@@ -139,22 +139,27 @@ Based on [Wikipedia's "Signs of AI writing"](https://en.wikipedia.org/wiki/Wikip
 | 16 | **Title Case Headings** | "Strategic Negotiations And Partnerships" | "Strategic negotiations and partnerships" |
 | 17 | **Emojis** | "🚀 Launch Phase: 💡 Key Insight:" | Remove emojis |
 | 18 | **Curly quotes** | `said “the project”` | `said "the project"` |
+| 19 | **Primary Single Quotes** | `stated, 'This is a pattern.'` | `stated, "This is a pattern."` |
+
+### Global Agent Context
+
+AI agents (Claude Code, Cursor, Windsurf, etc.) should use [AGENTS.md](file:///c:/Users/60217257/repos/humanizer/AGENTS.md) for repository orientation and core instructions.
 
 ### Communication Patterns
 
 | # | Pattern | Before | After |
 |---|---------|--------|-------|
-| 19 | **Chatbot artifacts** | "I hope this helps! Let me know if..." | Remove entirely |
-| 20 | **Cutoff disclaimers** | "While details are limited in available sources..." | Find sources or remove |
-| 21 | **Sycophantic tone** | "Great question! You're absolutely right!" | Respond directly |
+| 20 | **Chatbot artifacts** | "I hope this helps! Let me know if..." | Remove entirely |
+| 21 | **Cutoff disclaimers** | "While details are limited in available sources..." | Find sources or remove |
+| 22 | **Sycophantic tone** | "Great question! You're absolutely right!" | Respond directly |
 
 ### Filler and Hedging
 
 | # | Pattern | Before | After |
 |---|---------|--------|-------|
-| 22 | **Filler phrases** | "In order to", "Due to the fact that" | "To", "Because" |
-| 23 | **Excessive hedging** | "could potentially possibly" | "may" |
-| 24 | **Generic conclusions** | "The future looks bright" | Specific plans or facts |
+| 23 | **Filler phrases** | "In order to", "Due to the fact that" | "To", "Because" |
+| 24 | **Excessive hedging** | "could potentially possibly" | "may" |
+| 25 | **Generic conclusions** | "The future looks bright" | Specific plans or facts |
 
 ## Full Example
 
@@ -163,9 +168,8 @@ Based on [Wikipedia's "Signs of AI writing"](https://en.wikipedia.org/wiki/Wikip
 >
 > AI-assisted coding serves as an enduring testament to the transformative potential of large language models, marking a pivotal moment in the evolution of software development. In today's rapidly evolving technological landscape, these groundbreaking tools—nestled at the intersection of research and practice—are reshaping how engineers ideate, iterate, and deliver, underscoring their vital role in modern workflows.
 >
-> At its core, the value proposition is clear: streamlining processes, enhancing collaboration, and fostering alignment. It's not just about autocomplete; it's about unlocking creativity at scale, ensuring that organizations can remain agile while delivering seamless, intuitive, and powerful experiences to users. The tool serves as a catalyst. The assistant functions as a partner. The system stands as a foundation for innovation.
->
-> Industry observers have noted that adoption has accelerated from hobbyist experiments to enterprise-wide rollouts, from solo developers to cross-functional teams. The technology has been featured in The New York Times, Wired, and The Verge. Additionally, the ability to generate documentation, tests, and refactors showcases how AI can contribute to better outcomes, highlighting the intricate interplay between automation and human judgment.
+> At its core, the value proposition is clear: streamlining processes, enhancing collaboration, and fostering alignment. It's not just about autocomplete; it's about unlocking; The new software update serves as a testament to the company's commitment to innovation. Moreover, it provides a seamless, intuitive, and powerful user experience—ensuring that users can accomplish their goals efficiently. It's not just an update; it's a revolution in how we think about productivity. Industry experts believe this will have a lasting impact on the entire sector, highlighting the company's pivotal role in the evolving technological landscape.
+tion has accelerated from hobbyist experiments to enterprise-wide rollouts, from solo developers to cross-functional teams. The technology has been featured in The New York Times, Wired, and The Verge. Additionally, the ability to generate documentation, tests, and refactors showcases how AI can contribute to better outcomes, highlighting the intricate interplay between automation and human judgment.
 >
 > - 💡 **Speed:** Code generation is significantly faster, reducing friction and empowering developers.
 > - 🚀 **Quality:** Output quality has been enhanced through improved training, contributing to higher standards.
@@ -193,6 +197,8 @@ Based on [Wikipedia's "Signs of AI writing"](https://en.wikipedia.org/wiki/Wikip
 
 ## Version History
 
+- **2.2.0** - Added Pattern #19 (Primary Single Quotes)
+- **2.1.2** - Fixed YAML description (replaced "excessive conjunctive phrases" with "filler phrases")
 - **2.1.1** - Fixed pattern #18 example (curly quotes vs straight quotes)
 - **2.1.0** - Added before/after examples for all 24 patterns
 - **2.0.0** - Complete rewrite based on raw Wikipedia article content

SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: humanizer
-version: 2.1.1
+version: 2.2.0
 description: |
   Remove signs of AI-generated writing from text. Use when editing or reviewing
   text to make it sound more natural and human-written. Based on Wikipedia's
   comprehensive "Signs of AI writing" guide. Detects and fixes patterns including:
   inflated symbolism, promotional language, superficial -ing analyses, vague
   attributions, em dash overuse, rule of three, AI vocabulary words, negative
-  parallelisms, and excessive conjunctive phrases.
+  parallelisms, and filler phrases.
 allowed-tools:
   - Read
   - Write
@@ -42,15 +42,15 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as
 - Every sentence is the same length and structure
 - No opinions, just neutral reporting
 - No acknowledgment of uncertainty or mixed feelings
-- No first-person perspective when appropriate
+- No first-person perspective
 - No humor, no edge, no personality
 - Reads like a Wikipedia article or press release
 
 ### How to add voice
 
 **Have opinions.** Don't just report facts - react to them. "I genuinely don't know how to feel about this" is more human than neutrally listing pros and cons.
 
-**Vary your rhythm.** Short punchy sentences. Then longer ones that take their time getting where they're going. Mix it up.
+**Vary your rhythm.** Short, punchy sentences. Then longer ones that take their time getting where they're going. Mix it up.
 
 **Acknowledge complexity.** Real humans have mixed feelings. "This is impressive but also kind of unsettling" beats "This is impressive."
 
@@ -66,7 +66,7 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as
 
 ### After (has a pulse)
 >
-> I genuinely don't know how to feel about this one. 3 million lines of code, generated while the humans presumably slept. Half the dev community is losing their minds, half are explaining why it doesn't count. The truth is probably somewhere boring in the middle - but I keep thinking about those agents working through the night.
+> I genuinely don't know how to feel about this one. 3 million lines of code, generated while the humans presumably slept. Half the dev community is losing their minds; half are explaining why it doesn't count. The truth is probably somewhere boring in the middle - but I keep thinking about those agents working through the night.
 
 ---
 
@@ -191,7 +191,7 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as
 **Problem:** Constructions like "Not only...but..." or "It's not just about..., it's..." are overused.
 
 **Before:**
-> It's not just about the beat riding under the vocals; it's part of the aggression and atmosphere. It's not merely a song, it's a statement.
+> It's not just about the beat riding under the vocals; it's part of the aggression and atmosphere. It's not merely a song; it's a statement.
 
 **After:**
 > The heavy beat adds to the aggressive tone.
@@ -315,9 +315,21 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as
 
 ---
 
+### 19. Primary Single Quotes (Code-Style Quotation)
+
+**Problem:** AI models trained on code often use single quotes as primary delimiters.
+
+**Before:**
+> stated, 'This is a pattern.'
+
+**After:**
+> stated, "This is a pattern."
+
+---
+
 ## COMMUNICATION PATTERNS
 
-### 19. Collaborative Communication Artifacts
+### 20. Collaborative Communication Artifacts
 
 **Words to watch:** I hope this helps, Of course!, Certainly!, You're absolutely right!, Would you like..., let me know, here is a...
 
@@ -331,7 +343,7 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as
 
 ---
 
-### 20. Knowledge-Cutoff Disclaimers
+### 21. Knowledge-Cutoff Disclaimers
 
 **Words to watch:** as of [date], Up to my last training update, While specific details are limited/scarce..., based on available information...
 
@@ -345,7 +357,7 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as
 
 ---
 
-### 21. Sycophantic/Servile Tone
+### 22. Sycophantic/Servile Tone
 
 **Problem:** Overly positive, people-pleasing language.
 
@@ -359,7 +371,7 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as
 
 ## FILLER AND HEDGING
 
-### 22. Filler Phrases
+### 23. Filler Phrases
 
 **Before → After:**
 
@@ -372,7 +384,7 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as
 
 ---
 
-### 23. Excessive Hedging
+### 24. Excessive Hedging
 
 **Problem:** Over-qualifying statements.
 
@@ -384,7 +396,7 @@ Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as
 
 ---
 
-### 24. Generic Positive Conclusions
+### 25. Generic Positive Conclusions
 
 **Problem:** Vague upbeat endings.
 
@@ -423,7 +435,7 @@ Provide:
 **Before (AI-sounding):**
 > Great question! Here is an essay on this topic. I hope this helps!
 >
-> AI-assisted coding serves as an enduring testament to the transformative potential of large language models, marking a pivotal moment in the evolution of software development. In today's rapidly evolving technological landscape, these groundbreaking tools—nestled at the intersection of research and practice—are reshaping how engineers ideate, iterate, and deliver, underscoring their vital role in modern workflows.
+> The new software update serves as a testament to the company's commitment to innovation. Moreover, it provides a seamless, intuitive, and powerful user experience—ensuring that users can accomplish their goals efficiently. It's not just an update; it's a revolution in how we think about productivity. Industry experts believe this will have a lasting impact on the entire sector, highlighting the company's pivotal role in the evolving technological landscape.
 >
 > At its core, the value proposition is clear: streamlining processes, enhancing collaboration, and fostering alignment. It's not just about autocomplete; it's about unlocking creativity at scale, ensuring that organizations can remain agile while delivering seamless, intuitive, and powerful experiences to users. The tool serves as a catalyst. The assistant functions as a partner. The system stands as a foundation for innovation.
 >

adapters/antigravity-rules-workflows/README.md

@@ -1,7 +1,7 @@
 ---
 adapter_metadata:
   skill_name: humanizer
-  skill_version: 2.1.1
+  skill_version: 2.2.0
   last_synced: 2026-01-31
   source_path: SKILL.md
   adapter_id: antigravity-rules-workflows