docs: add AI agent instructions

[Xe]

Summary

This PR adds comprehensive documentation for AI agents working with the codebase and improves the build workflow organization.

Changes

• Documentation: Add AGENTS.md and CLAUDE.md with detailed guidance for AI agents
• Build: Add consolidated linting scripts to package.json
• CI: Simplify GitHub Actions workflow to use new consolidated lint command

Files Added/Modified

• AGENTS.md: Complete project guidance for Claude Code and other AI agents
• CLAUDE.md: Reference file that points to AGENTS.md
• package.json: Added organized linting scripts (lint, lint:format, lint:code)
• .github/workflows/test.yaml: Streamlined CI pipeline

Benefits

• Better organization of linting tasks
• Simplified CI workflow while maintaining code quality checks
• Comprehensive guidance for AI agents to work effectively with the codebase
• Clear attribution requirements for AI-assisted work

Test Plan

• Verify CI workflow runs successfully with new consolidated lint command
• Confirm all linting checks (API docs, ESLint, Prettier) are properly executed
• Test that documentation is accessible and accurate

Closes TIG-6655

Assisted-by: GLM 4.6 via Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
docs-redirect	Ready	Preview	Comment	Nov 12, 2025 5:48pm
tigris-os-docs	Ready	Preview	Comment	Nov 12, 2025 5:48pm

[greptile-apps]

Greptile Overview

Greptile Summary

This PR consolidates linting commands and adds AI agent documentation. The workflow simplification correctly replaces three separate lint commands with a single consolidated npm run lint command that executes them in sequence (lint:apidocs, lint:code, lint:format).

Key changes:

• Consolidated linting: Replaced individual npx prettier and npx eslint calls with organized npm scripts
• AI agent guidance: Added comprehensive documentation for Claude Code and other AI agents working with the codebase
• Attribution requirements: Established clear policy for AI-assisted contributions using "Assisted-by" commit footers

Minor issue found:

• AGENTS.md:1 has incorrect header title (# CLAUDE.md instead of # AGENTS.md)

Confidence Score: 4/5

• This PR is safe to merge with one minor syntax correction needed
• The changes are well-structured and improve project organization. The workflow consolidation maintains all existing checks while improving maintainability. The only issue is a header mismatch in AGENTS.md that should be corrected before merging.
• AGENTS.md requires attention for the header title correction

Important Files Changed

File Analysis

Filename	Score	Overview
.github/workflows/test.yaml	5/5	Simplified CI workflow to use consolidated npm run lint command, removing duplicate lint calls
package.json	5/5	Added organized linting scripts (lint, lint:format, lint:code) to consolidate code quality checks
AGENTS.md	4/5	Added comprehensive AI agent documentation with project overview, architecture, commands, and attribution requirements. Header title doesn't match filename.
CLAUDE.md	5/5	Reference file that redirects to AGENTS.md using @AGENTS.md syntax

[greptile-apps]

_{4 files reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}