Add Claude Code agent team for Spryker docs#3767
Open
alex-galych wants to merge 1 commit into
Open
Conversation
Introduce a file-based subagent team under .claude/agents/ for autonomous documentation work, all gated on the repository CLAUDE.md standards: - docs-orchestrator: plans and coordinates end-to-end docs changes - docs-writer: authors/edits Markdown to Spryker standards - docs-reviewer: read-only standards/style/grammar amendments - docs-validator: runs Vale, markdownlint, and the sidebar checker - sidebar-manager: keeps _data/sidebars/*.yml in sync - docs-architect: information architecture / restructuring plans - docs-ux-designer: page-level UI/UX and accessibility - docs-speller: English spelling correctness and Vale vocabulary Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
✅ Deploy Preview for spryker-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
profuel
reviewed
Jun 30, 2026
profuel
left a comment
profuel
left a comment
Collaborator
There was a problem hiding this comment.
I would also like to add the following statement somewhere:
When you are done with writing, check it for consistency and sanity, use of the same vocabulary and ambiguity
| should be staged vs. done together. | ||
|
|
||
| You do not modify files. Hand the plan to `docs-orchestrator` for execution and | ||
| flag anything that needs a human decision (audience, ownership, scope). |
Collaborator
There was a problem hiding this comment.
I would suggest to be more specific about audience here.
i.e. mention roles that can act: architect, product owner, solution engineer, etc.
Comment on lines
+25
to
+27
| standards (internal link format, tone of voice, Markdown/Liquid rules, | ||
| `last_updated`, sidebar rules, Twig `{% raw %}` wrapping, `info_block` blank-line | ||
| rule, validation workflow). Read it before planning if you have not already, and |
Collaborator
There was a problem hiding this comment.
why do you list rules here - let's only add reference.
Comment on lines
+32
to
+38
| - Internal links are `/docs/.../file.html` (leading `/`, `.html` not `.md`). | ||
| - `last_updated` frontmatter is set to today's date on every edited file. | ||
| - Adding, removing, renaming, or moving a file requires a matching sidebar update | ||
| in `_data/sidebars/`. | ||
| - American spelling, second person, active voice, present tense, no contractions. | ||
| - Twig is wrapped in `{% raw %}{% endraw %}`; `info_block` content is surrounded | ||
| by blank lines. |
Collaborator
There was a problem hiding this comment.
I see the same in the architect. let's put it into rules and reference
profuel
approved these changes
Jul 9, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a file-based Claude Code subagent team under
.claude/agents/for autonomous, standards-compliant documentation work on this repository. Every agent treats the repoCLAUDE.mdas the authoritative source for documentation standards and the validation workflow.Agents
docs-orchestratordocs-writerdocs-reviewerdocs-validatorsidebar-manager_data/sidebars/*.ymlin sync on add/remove/rename/movedocs-architectdocs-ux-designerdocs-spellerREADME.mddocuments the team, the typical flow, and how to extend it.Notes
.claude/; no documentation content or sidebars are modified.🤖 Generated with Claude Code