Skip to content

chore: add AI agent instruction files#676

Merged
pixelflips merged 1 commit intomainfrom
chore/add-ai-agent-instructions
Feb 18, 2026
Merged

chore: add AI agent instruction files#676
pixelflips merged 1 commit intomainfrom
chore/add-ai-agent-instructions

Conversation

@pixelflips
Copy link
Member

@pixelflips pixelflips commented Feb 13, 2026

Description

Adds standardized AI agent instruction files to the Pine repo to enforce project conventions when using AI coding tools. These files provide upfront context on commit types, branch naming, build commands, component patterns, and boundaries — reducing manual corrections and wasted tokens.

Fixes DSS-25

Files added

File Scope Audience
AGENTS.md Root All AI tools — Cursor, GitHub Copilot, OpenAI Codex, Google Jules, Aider, VS Code, etc...
.claude/CLAUDE.md Root Claude Code — loaded automatically every session
.cursor/rules/pine-project.mdc Always applied Cursor IDE — project-wide conventions
.cursor/rules/pine-components.mdc **/*.tsx only Cursor IDE — Stencil component development patterns

What the files cover

  1. Project structure — component layout, file conventions, pds- prefix, subcomponent nesting
  2. Git workflow — branch naming, commit type-by-file rules, PR template usage, no ticket numbers
  3. Build & test commands — Nx commands (npm run build.all, npm run test.all, npx nx run @pine-ds/core:test)
  4. Component development — Stencil decorators, Shadow DOM, event naming, JSDoc consistency
  5. Testing — spec/e2e test locations, coverage expectations
  6. Documentation — JSDoc terminology matching, MDX/Storybook patterns
  7. Boundaries — always sk first / never ignore guardrails to prevent destructive actions

Type of change

  • This change requires a documentation update

How Has This Been Tested?

  • tested manually

Test Configuration:

  • Pine versions: 3.17.0
  • OS: macOS
  • Browsers: N/A
  • Screen readers: N/A
  • Misc: Validated Claude Code loads .claude/CLAUDE.md automatically. Verified Cursor applies .mdc rules with correct glob scoping.

Checklist:

  • My code follows the style guidelines of this project
  • I have performed a self-review of my code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • New and existing tests pass locally with my changes

@netlify
Copy link

netlify bot commented Feb 13, 2026

Deploy Preview for pine-design-system ready!

Name Link
🔨 Latest commit c53945e
🔍 Latest deploy log https://app.netlify.com/projects/pine-design-system/deploys/698fb4fc79c3ca0008e6b7cc
😎 Deploy Preview https://deploy-preview-676--pine-design-system.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@pixelflips pixelflips self-assigned this Feb 13, 2026
Copy link
Contributor

@QuintonJason QuintonJason left a comment

Choose a reason for hiding this comment

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

🏆

@pixelflips pixelflips merged commit 76f0c5f into main Feb 18, 2026
15 checks passed
@pixelflips pixelflips deleted the chore/add-ai-agent-instructions branch February 18, 2026 01:03
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.

2 participants

Comments