OSS polish + launch hygiene (Jira-decouple, AGENTS.md, CONTRIBUTING, README hero) - #25
Merged
Merged
Conversation
- Jira-decouple 5 skills (tester, e2e-tester, reviewer, backend, frontend): reframe MANDATORY Jira sections to the file-based default; Jira/Confluence is an optional overlay enabled in workflow.yaml. - Emit AGENTS.md (root + claude/) mirroring CLAUDE.md so Cursor/Kiro/VS Code get identical guidance (those editors don't read CLAUDE.md). - Add CONTRIBUTING.md + .github issue templates (bug/feature/new-agent) + PR template. - README: editor badges (Claude Code/Cursor/Kiro/VS Code), 10-second hero, 'process not prompts' + vs-mega-prompt table; fix the Claude-Code-only and Jira-default framing.
There was a problem hiding this comment.
Pull request overview
This PR focuses on OSS “launch hygiene” and vendor-neutral framing by polishing top-level docs/templates, adding AGENTS.md variants for broader editor support, and updating several skills to treat Jira/Confluence as optional overlays rather than mandatory defaults.
Changes:
- Refreshes
README.mdpositioning (multi-editor support, “process-not-prompts” framing, workflow diagram, comparison table). - Adds contributor/PR/issue hygiene (
CONTRIBUTING.md, PR template, issue templates). - Reframes several skill docs to be “file-based by default” with Jira/Confluence as optional overlays, and introduces
AGENTS.mdfiles.
Reviewed changes
Copilot reviewed 14 out of 14 changed files in this pull request and generated 8 comments.
Show a summary per file
| File | Description |
|---|---|
| README.md | Adds multi-editor badges/hero copy and reframes the project as workflow-first (“process, not prompts”). |
| CONTRIBUTING.md | Introduces contribution guidance and a quick path for adding agents/references. |
| claude/skills/quality/testing/tester/SKILL.md | Rewords Jira/Confluence section toward file-based defaults; retains overlay examples. |
| claude/skills/quality/testing/e2e-tester/SKILL.md | Same reframing for E2E tester outputs and overlay usage. |
| claude/skills/quality/review/reviewer/SKILL.md | Same reframing for reviewer outputs and overlay usage. |
| claude/skills/development/frontend/react/frontend-developer/SKILL.md | Updates “recording work” wording toward file-based-by-default framing. |
| claude/skills/development/backend/java/backend-developer/SKILL.md | Updates “recording work” wording toward file-based-by-default framing. |
| claude/AGENTS.md | Adds editor-consumable agent instructions for the deployable claude/ content. |
| AGENTS.md | Adds root-level editor-consumable instructions intended to mirror CLAUDE.md. |
| .github/pull_request_template.md | Adds a structured PR template and contributor checklist. |
| .github/ISSUE_TEMPLATE/new_agent.md | Adds issue template for proposing new agents. |
| .github/ISSUE_TEMPLATE/feature_request.md | Adds feature request issue template. |
| .github/ISSUE_TEMPLATE/config.yml | Adds discussion link/contact guidance. |
| .github/ISSUE_TEMPLATE/bug_report.md | Adds bug report issue template. |
Comments suppressed due to low confidence (1)
claude/skills/quality/testing/tester/SKILL.md:105
- This section is framed as "file-based by default", but it immediately instructs creating the Test Plan in Confluence. If Confluence is intended to be optional, the heading (and/or the text) should make clear this is only for the overlay-enabled case.
### Writing Test Plans in Confluence
For every feature, /qa creates a **Test Plan** in the Confluence Test Plans section:
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
…/doc fixes - Skills (tester/e2e/reviewer/backend/frontend): add a 'tracker-agnostic' note to each recording section, make the output tables ticket-first (Jira/Confluence as 'if configured'), and genericize the hard-coded 'Read/Post/subtasks in Jira' steps. - claude/CLAUDE.md + claude/AGENTS.md: fix the stale '~48' -> ~29 (15 core + specialists). - AGENTS.md (root): retitle + reframe to be editor-neutral (was a CLAUDE.md copy); claude/AGENTS.md: add a mirror note. - PR template: correct paths to claude/commands/agents.md + claude/skills/disambiguation.md.
…oupling + AGENTS tree - backend/frontend: genericize the remaining 'Jira ticket' / 'comments in Jira' / 'documented in Jira comment' phrases to the tracker-agnostic ticket wording. - AGENTS.md: fix the repo-tree annotation (this file is AGENTS.md, mirrors CLAUDE.md).
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 15 out of 15 changed files in this pull request and generated 8 comments.
Comments suppressed due to low confidence (1)
claude/skills/quality/testing/tester/SKILL.md:106
- This section still makes Confluence sound like the default/required location, which conflicts with the new “file-based by default” framing. Reword it so the markdown KB is the default and Confluence is explicitly optional/conditional.
### Writing Test Plans in Confluence
For every feature, /qa creates a **Test Plan** in the Confluence Test Plans section:
…GENTS/CLAUDE accuracy - tester/e2e/reviewer: make the report-posting and bug-ticket subsections conditional — record in the ticket (Backlog.md) by default; Jira only if the overlay is configured. - AGENTS.md + root CLAUDE.md: workflow diagram now uses role commands + /verify; replace 'all features require /jorge' with the proportional-gates wording; fix stale counts (Skills 33->29, Commands 35->47, Templates 5->6).
…ing + README gates - tester/e2e/reviewer: genericize the remaining process tables, checklists and workflow examples to tracker-agnostic wording (ticket / KB doc / KB ADR / KB Feature Vision). Remaining 'Jira'/'Confluence' mentions are only the tracker-agnostic notes, explicitly-conditional overlay steps, and Atlassian tool-call examples. - CLAUDE.md/AGENTS.md structure block: 35 -> 47 slash commands. - README: Approval Gates table is now proportional (trigger/preset, not 'Always'); Jira & Confluence retitled an optional overlay with a file-based-default lead.
Comment on lines
+80
to
84
| | Output | Ticket / KB (default: file-based; Jira/Confluence if configured) | Agent-context file | | ||
| |--------|------|----------| | ||
| | Code review report | Comment on Story ticket | `reviews/rev-{ticket}.md` | | ||
| | Blocking issues | Comment on Story ticket | `reviews/rev-{ticket}.md` | | ||
| | Review verdict | Comment on Story ticket | `reviews/rev-{ticket}.md` | |
Comment on lines
+104
to
109
| ### Writing Test Plans (in the KB) | ||
|
|
||
| For every feature, /qa creates a **Test Plan** in the Confluence Test Plans section: | ||
| For every feature, /qa creates a **Test Plan** in the KB (the Confluence Test Plans section, if configured): | ||
|
|
||
| ``` | ||
| Tool: createConfluencePage |
Comment on lines
+17
to
+19
| | | One mega-prompt | **AI Dev Team** | | ||
| |---|---|---| | ||
| | Process | hope it remembers | **enforced gates** that can refuse to proceed | |
olehsvyrydov
added a commit
that referenced
this pull request
Jun 6, 2026
…README hero) (#25) * OSS polish + launch hygiene - Jira-decouple 5 skills (tester, e2e-tester, reviewer, backend, frontend): reframe MANDATORY Jira sections to the file-based default; Jira/Confluence is an optional overlay enabled in workflow.yaml. - Emit AGENTS.md (root + claude/) mirroring CLAUDE.md so Cursor/Kiro/VS Code get identical guidance (those editors don't read CLAUDE.md). - Add CONTRIBUTING.md + .github issue templates (bug/feature/new-agent) + PR template. - README: editor badges (Claude Code/Cursor/Kiro/VS Code), 10-second hero, 'process not prompts' + vs-mega-prompt table; fix the Claude-Code-only and Jira-default framing. * Address Copilot review on PR #25: finish the Jira-decoupling + AGENTS/doc fixes - Skills (tester/e2e/reviewer/backend/frontend): add a 'tracker-agnostic' note to each recording section, make the output tables ticket-first (Jira/Confluence as 'if configured'), and genericize the hard-coded 'Read/Post/subtasks in Jira' steps. - claude/CLAUDE.md + claude/AGENTS.md: fix the stale '~48' -> ~29 (15 core + specialists). - AGENTS.md (root): retitle + reframe to be editor-neutral (was a CLAUDE.md copy); claude/AGENTS.md: add a mirror note. - PR template: correct paths to claude/commands/agents.md + claude/skills/disambiguation.md. * Address Copilot re-review on PR #25: finish backend/frontend Jira-decoupling + AGENTS tree - backend/frontend: genericize the remaining 'Jira ticket' / 'comments in Jira' / 'documented in Jira comment' phrases to the tracker-agnostic ticket wording. - AGENTS.md: fix the repo-tree annotation (this file is AGENTS.md, mirrors CLAUDE.md). * Address Copilot re-review on PR #25: conditional Jira subsections + AGENTS/CLAUDE accuracy - tester/e2e/reviewer: make the report-posting and bug-ticket subsections conditional — record in the ticket (Backlog.md) by default; Jira only if the overlay is configured. - AGENTS.md + root CLAUDE.md: workflow diagram now uses role commands + /verify; replace 'all features require /jorge' with the proportional-gates wording; fix stale counts (Skills 33->29, Commands 35->47, Templates 5->6). * Address Copilot re-review on PR #25: thorough Jira/Confluence decoupling + README gates - tester/e2e/reviewer: genericize the remaining process tables, checklists and workflow examples to tracker-agnostic wording (ticket / KB doc / KB ADR / KB Feature Vision). Remaining 'Jira'/'Confluence' mentions are only the tracker-agnostic notes, explicitly-conditional overlay steps, and Atlassian tool-call examples. - CLAUDE.md/AGENTS.md structure block: 35 -> 47 slash commands. - README: Approval Gates table is now proportional (trigger/preset, not 'Always'); Jira & Confluence retitled an optional overlay with a file-based-default lead.
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
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.
What
The near-term polish bundle that finishes Phase 1's OSS-first promise and sets up for launch:
tester,e2e-tester,reviewer,backend-developer,frontend-developer) — reframed their MANDATORY Jira/Confluence sections to the file-based default (record in the ticket: Backlog.md by default, or the configured tracker). Jira/Confluence is now explicitly an optional overlay enabled inworkflow.yaml. (Examples preserved.)claude/) mirroringCLAUDE.md— Cursor / Kiro / VS Code readAGENTS.md, notCLAUDE.md, so this delivers the "works in 4 editors" promise.CONTRIBUTING.md(incl. "add an agent in ~5 minutes"),.github/ISSUE_TEMPLATE/(bug / feature / new-agent + config),.github/pull_request_template.md.Why
Makes the no-lock-in / works-everywhere / process-not-prompts positioning true in the repo itself — directly supporting the >100★ goal.
Verification
MANDATORYJira sections remain in any skill.AGENTS.mdmirrorsCLAUDE.md(root + claude/) — same guidance, editor-neutral (retitled + mirror note), so intentionally not byte-identical.