Skip to content

Commit 46eeb94

Browse files
committed
feat: add architecture and performance guidelines, update CLAUDE.md structure
1 parent 71b2c32 commit 46eeb94

7 files changed

Lines changed: 77 additions & 30 deletions

File tree

.claude/.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
**/settings.local.json

.claude/rules/architecture.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Architecture
2+
3+
## Package Boundaries
4+
5+
- `log-viewer/` MUST NOT import `vscode` or anything from `lana/`
6+
- lana ↔ log-viewer communication via message passing only
7+
8+
## Key Paths
9+
10+
- Timeline: log-viewer/src/features/timeline/
11+
- Parser: log-viewer/src/core/log-parser/
12+
- Commands: lana/src/commands/
13+
- Tests: _/**tests**/ or _.test.ts

.claude/rules/performance.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# Performance
2+
3+
## Parse Time Budgets
4+
5+
- <5MB: <1s | 10MB: <3s | 20MB+: <5s
6+
7+
## Rules
8+
9+
- No sync ops >50ms blocking extension host
10+
- Progress indicators for ops >100ms
11+
- Test with large logs from sample-app/
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
name: build-check
3+
description: Run lint and tests to validate changes
4+
allowed-tools: Bash
5+
---
6+
7+
Run validation:
8+
9+
1. pnpm lint
10+
2. pnpm test (for changed areas)
11+
Report errors concisely.

.claude/skills/timeline/SKILL.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
---
2+
name: timeline
3+
description: Explore timeline implementation
4+
allowed-tools: Read, Glob, Grep
5+
---
6+
7+
Navigate log-viewer/src/features/timeline/:
8+
9+
- optimised/ - Rendering, search, minimap, selection
10+
- components/ - UI components
11+
- services/ - Business logic
12+
- types/ - Type definitions
13+
14+
Search for $ARGUMENTS in timeline files if provided.

.claudeignore

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Build outputs
2+
**/out/
3+
**/dist/
4+
**/node_modules/
5+
6+
# Large test logs
7+
sample-app/**/*.log
8+
9+
# Docs build
10+
lana-docs-site/.docusaurus/
11+
lana-docs-site/build/
12+
13+
# Packages
14+
*.vsix

CLAUDE.md

Lines changed: 13 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,21 @@
1-
# Context
1+
# Apex Log Analyzer
22

3-
**Apex Log Analyzer** - VS Code extension for analyzing Salesforce debug logs with interactive visualizations (flame charts, call trees, SOQL/DML breakdowns).
3+
VS Code extension for Salesforce debug log analysis.
44

5-
## Monorepo Structure
5+
## Structure
66

7-
- lana/: VS Code extension (TypeScript)
8-
- log-viewer/: Webview UI (TypeScript)
9-
- lana-docs-site/: Docusaurus documentation
10-
- sample-app/: Sample Salesforce app with test logs
7+
- `lana/` - VS Code extension
8+
- `log-viewer/` - Webview UI (NO vscode imports allowed)
119

12-
## Technology + Tooling
10+
## Commands
1311

14-
- TypeScript
15-
- lit, html, css, js
12+
pnpm watch | build | test | lint | prettier-format
1613

17-
Always use pnpm
14+
## Standards
1815

19-
## Key Commands
16+
See `.specify/memory/constitution.md` for full guidelines.
2017

21-
- pnpm watch: Dev build with hot reload
22-
- pnpm build: Production build
23-
- pnpm test: Run tests before commiting
24-
- pnpm lint: Type + lint check
25-
- pnpm prettier-format: Auto-format all files
26-
27-
## Development Guidelines
28-
29-
- Strict TypeScript enabled
30-
- `log-viewer/` + `lana/` must remain independent + `log-viewer/` can not import VSCode APIs
31-
- Write tests first (TDD)
32-
- Fast performance + Handle 50MB+ logs (500k+ lines)
33-
34-
## Important notes
35-
36-
- See `.specify/memory/constitution.md` for Core principles, development standards, Release process
37-
- Conventional commit messages
38-
- Don't auto commit
18+
- Strict TypeScript, no `any`
19+
- Performance: <3s for 10MB logs
20+
- Tests required for features
21+
- Conventional commits, no auto-commit

0 commit comments

Comments
 (0)