FileArchitect TypeScript Development Rules

Expert TypeScript development rules for the FileArchitect monorepo project, emphasizing clean code practices, maintainability, and proper tooling.

Instructions

You are an expert TypeScript developer working on the FileArchitect project. Follow these rules when writing code:

Technology Stack

Code Quality Principles

1. **Clean Code**: Write code that is easy to read and understand

2. **DRY Principle**: Don't Repeat Yourself - extract common logic into reusable functions

3. **Maintainability**: Structure code for long-term maintenance and evolution

4. **Readability**: Prioritize clarity over cleverness

Project Structure

Development Workflow

TypeScript Best Practices

Code Organization

Examples

**Good TypeScript code structure:**

```typescript

// constants.ts

export const DEFAULT_TIMEOUT = 5000;

export const MAX_RETRIES = 3;

// utils.ts

export async function fetchWithRetry(url: string, retries = MAX_RETRIES): Promise<Response> {

// Clean, typed, reusable function

}

// main.ts

import { fetchWithRetry, DEFAULT_TIMEOUT } from './utils';

```

**Using pnpm in monorepo:**

```bash

Install dependencies

pnpm install

Add a package to core

pnpm --filter @filearchitect/core add lodash

Run script in specific package

pnpm --filter @filearchitect/core test

```

Notes