Skip to content

feat: enterprise FE patterns, project-tooling-discovery, explore commands, and team workflows#5

Open
vaibhav-systango wants to merge 3 commits into
mainfrom
feat/enterprise-fe-patterns-and-project-discovery
Open

feat: enterprise FE patterns, project-tooling-discovery, explore commands, and team workflows#5
vaibhav-systango wants to merge 3 commits into
mainfrom
feat/enterprise-fe-patterns-and-project-discovery

Conversation

@vaibhav-systango
Copy link
Copy Markdown
Collaborator

@vaibhav-systango vaibhav-systango commented May 14, 2026

Process Refinements — Agent Skill Library v1.1.0

Branch: feat/enterprise-fe-patterns-and-project-discovery
Scope: Process improvements only — no new commands, no framework tutorials


What This PR Does

Refines 20+ existing skills with process-level improvements, adds language-agnostic tooling discovery, and strengthens the frontend skill's architecture guidance — without introducing new slash commands or teaching framework-specific libraries to agents.


Changes

🧹 Removed (keeping the library clean)

  • 4 /explore-* slash commands — deferred; no new commands in this cycle
  • references/frontend-patterns.md — 608 lines of React 19 / Next.js 15 / Tailwind v4 tutorials removed
  • references/typescript-patterns.md — 117 lines of FE-specific TypeScript patterns removed
  • skills/solution-option-exploration/ — new skill deferred to next release
  • skills/engineering-artifact-generation/ — new skill deferred to next release

⚙️ Routing & Orchestration

File Change
AGENTS.md Added 10 missing intent → skill mappings; full lifecycle (DISCOVER → SHIP → EXPLORE → QUICK); removed references to deferred skills
CLAUDE.md Cleaned up command list, references list, and Explore phase (idea-refine only)
skills/using-agent-skills/SKILL.md Task Size Triage matrix; expanded routing table with all skills; removed /explore-* commands

🎨 Frontend UI Engineering (refined, not replaced)

  • Architecture Principles added: Atomic Design classification, SOLID for frontend, Module Boundaries with feature-based folder structure
  • Framework-agnostic state management table — library names replaced with generic categories (data-fetching library, state management library)
  • Error Boundaries — genericized (removed library name coupling)
  • FE Anti-Patterns table — stripped React 19-specific rows, kept framework-agnostic process rows
  • Red Flags section cleaned — removed Next.js-specific items

📦 New Reference File

  • references/project-tooling-discovery.md — language-agnostic guide for agents to discover project tooling (package manager, test runner, linter, CI) before making assumptions

🔧 Process Skill Enhancements (20 skills improved)

Skill What Changed
brownfield-discovery Targeted Reference Trace phase; project-tooling-discovery.md integration
incremental-implementation Narration examples; summary-file red flags
code-review-and-quality Changeset-first review discipline
shipping-and-launch Web Quality Gate — SEO, Core Web Vitals, a11y checklist
jira-board-sync Tempo Timesheets integration; work logging protocol
spec-driven-development Tooling-discovery reference notes
planning-and-task-breakdown Tooling-discovery reference notes
quick-task-execution Tooling-discovery reference notes
debugging-and-error-recovery Tooling-discovery reference notes
api-and-interface-design Tooling-discovery reference notes
documentation-and-adrs Tooling-discovery reference notes
generate-unit-tests Tooling-discovery reference notes
context-engineering Refinements
git-workflow-and-versioning Refinements
jira-planning-and-task-breakdown Refinements
planning-and-task-breakdown/templates.md Refinements

📄 New Docs

  • docs/team-rollout.md — organizational adoption guide (phased rollout, champion program, success metrics)

🔢 Plugin Version

  • Bumped plugin.json to 1.1.0

@vaibhav-systango vaibhav-systango force-pushed the feat/enterprise-fe-patterns-and-project-discovery branch 2 times, most recently from b7b5137 to d5893c3 Compare May 14, 2026 09:11
- Add references/frontend-patterns.md (608 lines) — React 19, Next.js 15,
  Tailwind v4, Zustand, React Query, Atomic Design, SOLID patterns
- Add references/typescript-patterns.md — safe window augmentation, strict TS
- Add skills/engineering-artifact-generation — commit/PR/chat messages
  grounded in git diff
- Add skills/solution-option-exploration — structured approach comparison
- Add 4 /explore-* slash commands
- Add docs/team-rollout.md — organizational adoption guide
- Enhance frontend-ui-engineering with App Router, Zustand, React Query,
  error boundaries, forms, data viz, anti-patterns table
- Enhance shipping-and-launch with Web Quality Gate (SEO, CWV, a11y)
- Enhance code-review-and-quality with changeset-first review
- Enhance brownfield-discovery with targeted reference tracing
- Enhance incremental-implementation with narration examples and red flags
- Enhance jira-board-sync with Tempo Timesheets and work logging
- Add tooling-discovery reference notes across 6 skills
- Update CLAUDE.md, AGENTS.md, using-agent-skills routing
- Bump plugin version to 1.1.0
@vaibhav-systango vaibhav-systango force-pushed the feat/enterprise-fe-patterns-and-project-discovery branch from d5893c3 to 241c984 Compare May 14, 2026 09:18
@vaibhav-systango vaibhav-systango changed the title feat: enterprise FE patterns, project-command-discovery, explore comm… feat: enterprise FE patterns, explore commands, and team workflows" May 14, 2026
@vaibhav-systango vaibhav-systango changed the title feat: enterprise FE patterns, explore commands, and team workflows" feat: enterprise FE patterns, project-tooling-discovery, explore commands, and team workflows May 14, 2026
- Remove references/frontend-patterns.md and references/typescript-patterns.md
- Remove 4 /explore-* command files (no new commands yet)
- Strip React 19, Next.js 15, Tailwind v4, library-specific sections from
  frontend-ui-engineering — retain architecture, a11y, anti-patterns
- Fix all cross-references to deleted files
- Keep process skills (solution-option-exploration, engineering-artifact-generation)
  as intent-mapped only
- Delete skills/solution-option-exploration/ (new skill, deferred to PR2)
- Delete skills/engineering-artifact-generation/ (new skill, deferred to PR2)
- Remove solution-option-exploration and engineering-artifact-generation
  intent mappings from AGENTS.md
- Simplify AGENTS.md EXPLORE lifecycle entry to idea-refine only
- Simplify CLAUDE.md Explore phase listing to idea-refine only
- Genericize library names in FE SKILL.md state management table
  (React Query/SWR → data-fetching library, Zustand/Redux → state management library)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant