Index of every page on this site: llms.txt
All skills
amanktyr avatar

/project-init

@5711aad
by Aman Ktyramanktyr/tailor6 stars
Run it yourself

Guides project initialization, interactive product discovery, developer expertise assessment, stack selection matrix, and automated Architecture Decision Record (ADR) setup.

  • 1 file
  • 3.7 KB
  • Updated 3 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/amanktyr/tailor/project-init

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈47 tokens for metadata: the name and description. ≈886 when used: this file.

Description uses 2.4% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈188 characters, or 2.4%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Project Initialization Skill

Activate this skill when bootstrapping a new project from scratch, establishing architectural baselines, or executing /init-project.

Operational Directive: Never write code before establishing product scope, technical requirements, and developer expertise.


1. Product Discovery Questionnaire

Before recommending or installing any framework, gather critical product invariants:

  1. Target Product & Core Value Proposition: What is being built, what core problem does it solve, and who are the primary users?
  2. Platform & Modality: Public SaaS, internal dashboard, mobile API, desktop application, or developer CLI?
  3. Scale & Traffic Expectations: Prototype / MVP, internal team tool (<100 users), or high-throughput multi-tenant production system?
  4. Data Model & Concurrency: Relational data (PostgreSQL/MySQL), document-based (MongoDB), key-value cache (Redis), or embedded (SQLite)?
  5. Deployment & Runtime Constraints: Serverless (Vercel/Cloudflare Workers), containerized cluster (Docker/Kubernetes), single VPS, or static hosting?

2. Developer Expertise Matrix

Assess the developer's familiarity level (Beginner, Intermediate, Advanced, Expert):

  • Languages: TypeScript, Python, Go, Rust, C#, PHP, Java
  • Frontend Frameworks: Next.js (App Router), React (SPA), Vue / Nuxt, SvelteKit, Vanilla HTML/CSS
  • Backend Frameworks: Express / Fastify, NestJS, Django / FastAPI, Go Gin / Echo, ASP.NET Core, Laravel
  • Databases & ORMs: Prisma, Drizzle, TypeORM, SQLAlchemy, Django ORM, Entity Framework Core, Raw SQL

Rule: Never recommend a complex, unfamiliar stack for an urgent MVP if a well-understood, robust alternative achieves the goal in half the time.


3. Technology Stack Recommendation Matrix

Project Archetype Recommended Stack Key Rationale
Full-Stack SaaS / Web App Next.js (App Router) + TypeScript + Tailwind CSS + PostgreSQL + Prisma/Drizzle Unified language, fast server-side rendering, robust ORM, rapid UI iterations
High-Performance API Service Go (net/http + Gin) OR FastAPI (Python) + PostgreSQL + Redis High concurrency, low memory footprint, strict typing, auto-generated OpenAPI
Data Science / ML Backend Python + FastAPI + PyTorch / Scikit-learn + PostgreSQL + Celery/Redis Native ML ecosystem support, async performance, robust data processing
Enterprise Internal Tool Next.js + React + shadcn/ui + PostgreSQL + Supabase / Auth.js Rapid scaffolding, enterprise UI primitives, integrated authentication
Fast Developer CLI Tool Node.js (TypeScript + Commander + Picocolors) OR Rust (Clap) Zero-config distribution via npx, fast startup, deterministic execution
Micro-Service / Embedded Go OR Rust + SQLite / PostgreSQL Zero runtime dependencies, single static binary, instant cold start

4. Initialization Output & Memory Scaffolding

Upon stack confirmation, generate the baseline architecture:

  1. Initialize .ai/ memory directory with:
    • INDEX.md: Top-level memory index.
    • CONSTITUTION.md: Project non-negotiables, intensity mode, and coding standards.
    • STACK.md: Confirmed frameworks, runtimes, and dependencies.
    • ARCHITECTURE.md: High-level system topology and boundaries.
    • DECISIONS.md: Initial ADR-001 (Technology Stack & Baseline Architecture).
  2. Synchronize multi-agent adapter rules (CLAUDE.md, .cursorrules, AGENTS.md, GEMINI.md).

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 5711aad. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 3 months ago

README badge

README badge for amanktyr/tailor/project-init