Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions .claude/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,6 @@ The project is split into multiple packages under the `packages/` directory:
- `/web`: Frontend application built with React, TanStack Start, TanStack Router (deployed on Cloudflare Workers)
- `/workers`: Backend services, API endpoints, and database migrations
- `/shared`: Shared TypeScript utilities and error definitions
- `/mcp`: MCP server for development tools and documentation
- `/docs`: Vitepress docs site containing internal documentation

The web package is the main frontend. It is deployed as a single Cloudflare Worker.
Expand Down Expand Up @@ -151,7 +150,7 @@ retries += 1;
## Documentation

- **Primary source**: Comprehensive guides are in the docs site (`packages/docs/`) - run `pnpm docs` to view
- **ALWAYS use Corates MCP tools or other MCP** for Better-Auth, Drizzle, Icons, and linting
- **External library docs**: Prefer reading source from cloned upstream repos in the `reference/` directory over ad-hoc web fetches. If a library isn't there yet and you need its source, clone it in with `git clone --depth 20 https://github.com/owner/repo.git reference/repo`. This works better than MCP-style doc fetchers for deep questions.
- **TanStack documentation**: Use the TanStack CLI: `npx @tanstack/cli search-docs "<query>" --library <router|start|query> --framework react --json`
- **Hono documentation**: Use the `hono` CLI for Hono docs. Run `hono docs [path]` to view docs, `hono search <query>` to fuzzy search, or `hono --help` for all commands
- **For comprehensive documentation**, see the docs site guides in `packages/docs/guides/`:
Expand Down
20 changes: 2 additions & 18 deletions .github/Contributing.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,6 @@ This is a pnpm monorepo with the following packages:
| `packages/workers` | Cloudflare Workers backend (Hono) |
| `packages/ui` | Shared UI component library |
| `packages/shared` | Shared error definitions and utilities |
| `packages/mcp` | MCP server for AI agent integration |

## Quick Start

Expand Down Expand Up @@ -149,25 +148,10 @@ pnpm openapi

For secured endpoints, sign in via the frontend first (http://localhost:3010). The API docs will use your authenticated session.

## MCP Server (AI Agent Integration)
## AI Agent Integration

This repository is optimized for AI agent workflows. It includes copilot-instructions, claude instructions, and cursor instructions.
If asked to create a plan file, agents will create them in docs/plans
This project includes a custom MCP server for AI agent context:

```sh
pnpm run initialize-mcp

# In VS Code:
# 1. Press Cmd+Shift+P or Ctrl+Shift+P
# 2. Type "MCP: List Servers"
# 3. Find 'corates' and start it

# In Cursor:
# 1. Press Cmd+Shift+P or Ctrl+Shift+P
# 2. Type "Open MCP Settings"
# 3. Find 'corates' and start it if it has not been found and started already
```
If asked to create a plan file, agents will create them in `packages/docs/audits`.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Fix singular/plural wording for clarity.

Line 154 says “a plan file” but then uses “them.” Use singular (“it”) or pluralize the first phrase.

Proposed wording fix
-If asked to create a plan file, agents will create them in `packages/docs/audits`.
+If asked to create a plan file, agents will create it in `packages/docs/audits`.
Based on learnings: Maintain source of truth policy: Documentation is authoritative. If code conflicts with documentation, either fix the code or update the documentation.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
If asked to create a plan file, agents will create them in `packages/docs/audits`.
If asked to create a plan file, agents will create it in `packages/docs/audits`.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.github/Contributing.md at line 154, Change the mismatched singular/plural
in the sentence "If asked to create a plan file, agents will create them in
`packages/docs/audits`" so the subject and pronoun agree; either make the
subject plural ("If asked to create plan files, agents will create them in
`packages/docs/audits`.") or make the pronoun singular ("If asked to create a
plan file, an agent will create it in `packages/docs/audits`."). Update the
sentence accordingly in Contributing.md.


## Useful Commands

Expand Down
3 changes: 1 addition & 2 deletions .github/copilot-instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,6 @@ The project is split into multiple packages under the `packages/` directory:
- `/web`: Frontend application built with React, TanStack Start, TanStack Router (deployed on Cloudflare Workers)
- `/workers`: Backend services, API endpoints, and database migrations
- `/shared`: Shared TypeScript utilities and error definitions
- `/mcp`: MCP server for development tools and documentation
- `/docs`: Vitepress docs site containing internal documentation

The web package is the main frontend. It is deployed as a single Cloudflare Worker.
Expand Down Expand Up @@ -140,7 +139,7 @@ retries += 1;
## Documentation

- **Primary source**: Comprehensive guides are in the docs site (`packages/docs/`) - run `pnpm docs` to view
- **ALWAYS use Corates MCP tools or other MCP** for Better-Auth, Drizzle, Icons, linting, and Ark UI documentation
- **External library docs**: Prefer reading source from cloned upstream repos in the `reference/` directory over ad-hoc web fetches. Clone with `git clone --depth 20 https://github.com/owner/repo.git reference/repo` if not already present.
- **For comprehensive documentation**, see the docs site guides in `packages/docs/guides/`:
- testing.md - Frontend and backend testing patterns, setup, and best practices
- authentication.md - Setup, configuration, API endpoints, and usage patterns
Expand Down
27 changes: 0 additions & 27 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
Expand Up @@ -50,33 +50,6 @@ updates:
- '*'
dependency-type: 'development'

# MCP package
- package-ecosystem: 'npm'
directory: '/packages/mcp'
schedule:
interval: 'weekly'
day: 'monday'
time: '09:00'
open-pull-requests-limit: 3
labels:
- 'dependencies'
- 'mcp'
versioning-strategy: increase
commit-message:
prefix: 'chore'
prefix-development: 'chore'
include: 'scope'
rebase-strategy: 'auto'
groups:
mcp-dependencies:
patterns:
- '*'
dependency-type: 'production'
mcp-dev-dependencies:
patterns:
- '*'
dependency-type: 'development'

# Shared package
- package-ecosystem: 'npm'
directory: '/packages/shared'
Expand Down
9 changes: 0 additions & 9 deletions .mcp.json

This file was deleted.

5 changes: 0 additions & 5 deletions .mcp.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,5 @@
<!-- {
"mcpServers": {
"corates": {
"type": "stdio",
"command": "node",
"args": ["packages/mcp/dist/server.js"]
},
"ark-ui": {
"type": "stdio",
"command": "npx",
Expand Down
5 changes: 0 additions & 5 deletions .vscode/mcp.json
Original file line number Diff line number Diff line change
@@ -1,10 +1,5 @@
{
"servers": {
"corates": {
"type": "stdio",
"command": "node",
"args": ["${workspaceFolder}/packages/mcp/dist/server.js"]
},
"ark-ui": {
"command": "npx",
"args": ["-y", "@ark-ui/mcp"]
Expand Down
2 changes: 0 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,6 @@ CoRATES is a web application designed to streamline the entire quality and risk-
- **Build Orchestration**: Turbo
- **Linting**: ESLint with custom CoRATES rules
- **Code Format**: Prettier
- **CoRATES MCP**: Custom MCP server for CoRATES specific AI tooling
- **AI Compatible**: Claude plugins and skills, Cursor rules, and VS Code instructions
- **Type Safety**: TypeScript with tsconfig.json path aliases

Expand All @@ -72,7 +71,6 @@ CoRATES is a web application designed to streamline the entire quality and risk-
- `packages/ui` - Shared UI component library
- `packages/shared` - Shared TypeScript utilities, types, and error definitions
- `packages/docs` - Vitepress documentation and guides
- `packages/mcp` - MCP server for development tools and documentation
- `packages/stripe-dev` - Stripe setup for Turbo

## License
Expand Down
4 changes: 0 additions & 4 deletions knip.config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -41,10 +41,6 @@ const config: KnipConfig = {
entry: ['src/index.ts'],
project: ['src/**/*.ts'],
},
'packages/mcp': {
entry: ['src/index.ts'],
project: ['src/**/*.ts'],
},
'packages/docs': {
ignore: ['**/*'],
},
Expand Down
1 change: 0 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,6 @@
"format": "prettier --write .",
"lint": "eslint .",
"lint:fix": "eslint . --fix",
"initialize-mcp": "pnpm --filter mcp run scrape:all",
"test:ui": "pnpm --filter web test",
"test": "pnpm --recursive run test",
"typecheck": "pnpm --recursive run typecheck",
Expand Down
1 change: 0 additions & 1 deletion packages/docs/STATUS.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,6 @@ This document tracks the current implementation status of CoRATES features and s
| --------------- | -------- | ----------------------------- |
| @corates/ui | Complete | Ark UI wrappers (re-exports) |
| @corates/shared | Complete | Error types, plan definitions |
| @corates/mcp | Complete | Development MCP tools |

---

Expand Down
1 change: 0 additions & 1 deletion packages/docs/plans/yjs-awareness.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,4 +75,3 @@ Shows other users' cursor positions in shared editors.
- [y-protocols sync](https://github.com/yjs/y-protocols/blob/master/sync.js)
- [y-protocols awareness](https://github.com/yjs/y-protocols/blob/master/awareness.js)
- [Yjs docs - Providers](https://docs.yjs.dev/ecosystem/connection-provider)
- Use the CoRATES MCP tools for Yjs docs
6 changes: 0 additions & 6 deletions packages/mcp/.gitignore

This file was deleted.

83 changes: 0 additions & 83 deletions packages/mcp/README.md

This file was deleted.

32 changes: 0 additions & 32 deletions packages/mcp/__tests__/better-auth.test.ts

This file was deleted.

31 changes: 0 additions & 31 deletions packages/mcp/__tests__/drizzle.test.ts

This file was deleted.

45 changes: 0 additions & 45 deletions packages/mcp/__tests__/icons.test.ts

This file was deleted.

Loading