Skip to content

feat(content): add humanise subagent for AI writing pattern removal #128

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
marcusquinn merged 2 commits into from
Jan 20, 2026
Merged

feat(content): add humanise subagent for AI writing pattern removal #128

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a8ce990
feat(content): add humanise subagent for AI writing pattern removal
marcusquinn Jan 20, 2026
9de8459
fix: show curl errors for better debugging
marcusquinn Jan 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions .agent/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -173,7 +173,7 @@ User confirms with numbered options to override if needed.
| `todo/tasks/prd-*.md` | Product requirement documents |
| `todo/tasks/tasks-*.md` | Implementation task lists |

**Slash commands:** `/save-todo`, `/plan-status`, `/create-prd`, `/generate-tasks`, `/log-time-spent`, `/ready`, `/sync-beads`, `/remember`, `/recall`, `/session-review`, `/full-loop`, `/code-simplifier`
**Slash commands:** `/save-todo`, `/plan-status`, `/create-prd`, `/generate-tasks`, `/log-time-spent`, `/ready`, `/sync-beads`, `/remember`, `/recall`, `/session-review`, `/full-loop`, `/code-simplifier`, `/humanise`

**Time tracking format:**

Expand Down Expand Up @@ -406,7 +406,7 @@ Subagents provide specialized capabilities. Read them when tasks require domain
| `aidevops/` | Framework internals - extending aidevops, adding MCPs, architecture decisions | setup, architecture, add-new-mcp-to-aidevops, troubleshooting, mcp-integrations |
| `memory/` | Cross-session memory - SQLite FTS5 storage, /remember and /recall commands | README (system docs) |
| `seo/` | Search optimization - keyword research, rankings, site audits, E-E-A-T scoring, sitemap submission | dataforseo, serper, google-search-console, gsc-sitemaps, site-crawler, eeat-score, domain-research |
| `content/` | Content creation - copywriting standards, editorial guidelines, tone of voice | guidelines |
| `content/` | Content creation - copywriting standards, editorial guidelines, tone of voice, AI writing pattern removal | guidelines, humanise |
| `tools/content/` | Content tools - summarization, extraction, processing | summarize |
| `tools/social-media/` | Social media tools - X/Twitter CLI, posting, reading | bird |
| `tools/build-agent/` | Agent design - composing efficient agents, reviewing agent instructions | build-agent, agent-review |
Expand Down Expand Up @@ -436,7 +436,7 @@ Subagents provide specialized capabilities. Read them when tasks require domain
| `workflows/` | Development processes - branching, releases, PR reviews, quality gates | git-workflow, plans, release, version-bump, pr, review-issue-pr, preflight, postflight, ralph-loop, session-review |
| `templates/` | Document templates - PRDs, task lists, planning documents | prd-template, tasks-template, plans-template, todo-template |
| `workflows/branch/` | Branch conventions - naming, purpose, merge strategies per branch type | feature, bugfix, hotfix, refactor, chore, experiment, release |
| `scripts/commands/` | Slash commands - save-todo, remember, recall, code-simplifier and other interactive commands | save-todo, remember, recall, code-simplifier |
| `scripts/commands/` | Slash commands - save-todo, remember, recall, code-simplifier, humanise and other interactive commands | save-todo, remember, recall, code-simplifier, humanise |

<!-- AI-CONTEXT-END -->

Expand Down Expand Up @@ -565,6 +565,7 @@ Never create files in `~/` root for files needed only with the current task.
| `ralph-loop-helper.sh` | Iterative AI development loops (Ralph technique) |
| `full-loop-helper.sh` | End-to-end development loop (task → PR → deploy) |
| `session-review-helper.sh` | Gather session context for completeness review |
| `humanise-update-helper.sh` | Check for upstream updates to humanise subagent |

## Quality Workflow

Expand Down
20 changes: 17 additions & 3 deletions .agent/content.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ mode: subagent
subagents:
# Content
- guidelines
- humanise
- summarize
# SEO integration
- keyword-research
Expand All @@ -31,6 +32,7 @@ subagents:

**Subagents** (`content/`):
- `guidelines.md` - Content standards and style guide
- `humanise.md` - Remove AI writing patterns, make text sound human

**Integrations**:
- `seo.md` - Keyword optimization
Expand Down Expand Up @@ -63,6 +65,17 @@ See `content/guidelines.md` for:
- SEO requirements
- Quality checklist

### Humanising Content

Use `/humanise` or `content/humanise.md` to remove AI writing patterns:
- Inflated significance and promotional language
- Vague attributions and weasel words
- AI vocabulary (delve, tapestry, landscape, etc.)
- Rule of three, negative parallelisms
- Em dash overuse, excessive hedging

The humanise subagent is adapted from [blader/humanizer](https://github.com/blader/humanizer), based on Wikipedia's "Signs of AI writing" guide.
Comment on lines +68 to +77
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot Jan 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Quick Reference workflow still omits the Humanise step.

The top workflow list still shows Optimize as step 4, which conflicts with the new Humanise step. Please update it for consistency.

🛠️ Suggested update to the Quick Reference workflow list 
-4. Optimize (SEO, readability)
-5. Publish (via WordPress or CMS)
+4. Humanise (remove AI patterns, add voice)
+5. Optimize (SEO, readability)
+6. Publish (via WordPress or CMS)
🤖 Prompt for AI Agents 
In @.agent/content.md around lines 68 - 77, The Quick Reference workflow list at
the top of .agent/content.md is inconsistent with the new "Humanising Content"
section: it still lists "Optimize" as step 4 and omits the Humanise step. Update
the Quick Reference workflow list to include the Humanise step (referencing the
/humanise command or content/humanise.md) and renumber the subsequent steps so
"Optimize" follows the Humanise step; ensure the list labels and ordering match
the "Humanising Content" header and its description.


### Publishing

Integrate with WordPress workflow:
Expand Down Expand Up @@ -94,9 +107,10 @@ When oh-my-opencode is installed, leverage these specialized agents for enhanced
1. Research → @librarian finds examples and best practices
2. Outline → Content agent structures the piece
3. Draft → @document-writer creates polished prose
4. Optimize → SEO agent adds keywords, meta
5. Visual → @multimodal-looker analyzes/describes images
6. Publish → WordPress agent deploys
4. Humanise → /humanise removes AI patterns, adds voice
5. Optimize → SEO agent adds keywords, meta
6. Visual → @multimodal-looker analyzes/describes images
7. Publish → WordPress agent deploys
```

**Note**: These agents require [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) plugin.
Expand Down
Loading
Loading