H-5814: Adjust CLAUDE and AGENTS for lighter context & wider compatibility (#8173)

Co-authored-by: Dei Vilkinsons <[email protected]>

Author: lunelson

.augment/rules/ark-ui.md

@@ -0,0 +1 @@
+../../.config/agents/rules/ark-ui.md

.augment/rules/mastra.md

@@ -0,0 +1 @@
+../../.config/agents/rules/mastra.md

.augment/rules/panda-css.md

@@ -0,0 +1 @@
+../../.config/agents/rules/panda-css.md

.augment/rules/zod.md

@@ -0,0 +1 @@
+../../.config/agents/rules/zod.md

.augmentignore

@@ -0,0 +1,3 @@
+_temp
+_trash
+_holding

.claude/skills/ark-ui/SKILL.md

@@ -0,0 +1 @@
+../../../.config/agents/rules/ark-ui.md

.claude/skills/exploring-rust-crates/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: exploring-rust-crates
+description: Generating Rust documentation to understand crate APIs, structure, and usage. Use when exploring Rust code, understanding crate organization, finding functions/types/traits, or needing context about a Rust package in the HASH workspace. (project)
+---
+
+# Exploring Rust Crates
+
+## Purpose
+
+Guide for generating and using Rust documentation to understand crate APIs, structure, and code organization in the HASH workspace.
+
+## When to Use
+
+- Understanding a new Rust crate's API
+- Exploring available functions, types, and traits
+- Finding usage examples in doctest code blocks
+- Understanding crate organization and component relationships
+- Getting context about error conditions and handling
+- Generating test data based on documented structures
+
+## Generating Documentation
+
+### For a Specific Package
+
+```bash
+cargo doc --no-deps --all-features --package <package-name>
+```
+
+### For the Entire Workspace
+
+```bash
+cargo doc --no-deps --all-features --workspace
+```
+
+### Key Flags
+
+- `--no-deps`: Only document local code, not dependencies (faster, less noise)
+- `--all-features`: Include all feature-gated APIs
+- `--package <name>`: Target a specific crate
+- `--workspace`: Document all crates in the workspace
+
+## What Generated Docs Provide
+
+1. **Crate organization** - Module hierarchy and component relationships
+2. **Public API surface** - All public functions, types, traits, and constants
+3. **Usage examples** - Code examples from doctest blocks
+4. **Error documentation** - Documented error conditions and handling
+5. **Type relationships** - Trait implementations, type aliases, associated types
+
+## Viewing the Documentation
+
+After generation, docs are available at:
+
+```txt
+target/doc/<crate_name>/index.html
+```
+
+Open in browser or use the content for understanding the API structure.
+
+## Tips
+
+- Generate docs before diving into unfamiliar Rust code
+- Use `--document-private-items` if you need to understand internal implementation
+- Cross-reference with `# Errors` sections for error handling patterns
+- Look for `# Examples` sections for idiomatic usage patterns

.claude/skills/managing-git-workflow/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: managing-git-workflow
+description: Git workflow for HASH including branch naming, PR creation, and PR reviews. Use when creating branches, making commits, opening pull requests, or reviewing PRs. Covers Linear issue integration (H-XXXX format), PR templates, and review procedures. (project)
+---
+
+# Managing Git Workflow
+
+## Purpose
+
+Standardized git workflow for HASH development, ensuring traceability between code changes and Linear issues.
+
+## When to Use
+
+- Creating a new branch for a feature or fix
+- Opening a pull request
+- Reviewing someone else's PR
+- Understanding PR conventions
+
+---
+
+## Branch Naming
+
+**Format:** `<shortname>/h-XXXX-description`
+
+- `shortname`: Your identifier (first initial, nickname, etc.)
+- `h-XXXX`: Linear ticket number (lowercase 'h')
+- `description`: Brief kebab-case description
+
+**Examples:**
+
+- `t/h-4892-support-baseurl-and-version-filter`
+- `alice/h-1234-add-user-authentication`
+- `bob/h-5678-fix-database-connection`
+
+**Why this matters:**
+
+- Links code changes to Linear issues
+- Enables progress tracking on tickets
+- Maintains clear development history
+
+---
+
+## Pull Request Creation
+
+### PR Title Format
+
+**Format:** `H-XXXX: Description`
+
+- Use uppercase 'H' in PR titles (unlike branch names)
+- Description should be clear and concise
+
+**Examples:**
+
+- `H-4922: Add branch naming instructions to CLAUDE.md`
+- `H-1234: Implement user authentication system`
+- `H-5678: Fix database connection timeout`
+
+### PR Template
+
+Use the template at `.github/pull_request_template.md`. Key sections:
+
+1. **Purpose** - High-level explanation of what and why
+2. **Related links** - Linear issues, discussions, context
+3. **What does this change?** - Specific implementation details
+4. **Pre-merge checklist:**
+   - Publishable library changes (npm/Cargo)
+   - Documentation requirements
+   - Turbo Graph impact
+5. **Known issues** - Intentional omissions or limitations
+6. **Next steps** - Planned follow-ups
+7. **Tests** - What automated tests cover this
+8. **How to test** - Manual testing instructions
+9. **Demo** - Screenshots or videos
+
+---
+
+## PR Review Process
+
+### Step 1: Gather Information
+
+Run these commands to get full context:
+
+```bash
+# View PR metadata, description, and comments
+gh pr view <PR_NUMBER> --comments
+
+# View ALL changes (don't truncate!)
+gh pr diff <PR_NUMBER>
+
+# View inline diff comments
+gh api \
+  -H "Accept: application/vnd.github+json" \
+  -H "X-GitHub-Api-Version: 2022-11-28" \
+  /repos/hashintel/hash/pulls/<PR_NUMBER>/comments
+```
+
+**Important:** Always view the FULL diff. Don't pipe into `head` or use `--name-only`.
+
+### Step 2: Check Linear Issues
+
+Look for `H-XXXX` references in the PR title/description, then fetch the issue:
+
+```bash
+# If you have Linear MCP configured:
+mcp__linear__get_issue --issueId "H-XXXX"
+
+# Or use Linear web UI
+```
+
+Use the Linear issue requirements as baseline for your review.
+
+### Step 3: Provide Feedback
+
+- Be precise about issue locations (file:line)
+- Include suggestions for improvement
+- Reference relevant code standards
+- Distinguish blocking issues from suggestions
+
+---
+
+## Quick Reference
+
+| Action        | Format                                                 |
+| ------------- | ------------------------------------------------------ |
+| Branch name   | `<shortname>/h-XXXX-description`                       |
+| PR title      | `H-XXXX: Description`                                  |
+| View PR       | `gh pr view <NUMBER> --comments`                       |
+| View diff     | `gh pr diff <NUMBER>`                                  |
+| View comments | `gh api /repos/hashintel/hash/pulls/<NUMBER>/comments` |

.claude/skills/mastra/SKILL.md

@@ -0,0 +1 @@
+../../../.config/agents/rules/mastra.md

.claude/skills/panda-css/SKILL.md

@@ -0,0 +1 @@
+../../../.config/agents/rules/panda-css.md