dev-init

dev-init

Trigger Conditions

Automatically apply this skill when:

• Initializing new projects
• Setting up Docker containerization
• Creating or updating development logs
• Configuring development environment
• User mentions "devlog", "changelog", or project structure

Project Directory Structure

project-root/
├── README.md
├── docker-compose.yml
├── .env
├── backend/
│   ├── api/
│   ├── config/
│   ├── migrations/
│   ├── models/
│   ├── repositories/
│   ├── scripts/
│   ├── service/
│   ├── .python-version
│   ├── Dockerfile
│   ├── __init__.py
│   ├── alembic.ini
│   └── requirements.txt
├── frontend/
│   └── (generated by npx create-next-app@latest)
└── logs/
    ├── daily/
    │   └── {yyyy-mm-dd}_devlog.md
    ├── monthly/
    │   └── {month_name}_devlog.md
    └── changelog.md

Backend Structure (FastAPI)

Directory/File	Purpose
api/	API endpoints, routers
config/	Configuration settings
migrations/	Alembic database migrations
models/	SQLAlchemy models
repositories/	Data access layer
scripts/	Utility scripts
service/	Business logic layer
alembic.ini	Alembic configuration

Frontend Setup (Next.js)

Initialize with:

npx create-next-app@latest frontend

---

Docker Configuration

docker-compose.yml (Full-stack: PostgreSQL + FastAPI + Next.js)

services:
  db:
    env_file:
      - .env
    image: pgvector/pgvector:pg17
    container_name: {project_name}
    ports:
      - "5433:5432"
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
    volumes:
      - postgres-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 5

  backend:
    build:
      context: ./backend
      dockerfile: Dockerfile
    container_name: {project_name}-backend
    ports:
      - "8000:8000"
    env_file:
      - .env
    environment:
      DB_URL: postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB}
    depends_on:
      db:
        condition: service_healthy
    volumes:
      - ./backend/logs:/app/logs

  frontend:
    build:
      context: ./frontend
      dockerfile: Dockerfile
      args:
        NEXT_PUBLIC_API_URL: http://localhost:8000
    container_name: {project_name}-frontend
    ports:
      - "3000:3000"
    depends_on:
      - backend

volumes:
  postgres-data:

Environment Variables (.env)

# Local Environment
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_DB=postgres
DB_URL=postgresql://postgres:postgres@localhost:5432/postgres

---

Dockerfile Templates

Backend (FastAPI + Python 3.13)

Location: backend/Dockerfile

FROM python:3.13-slim
WORKDIR /app

RUN apt-get update && apt-get install -y \
    gcc \
    libpq-dev \
    && rm -rf /var/lib/apt/lists/*

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .
EXPOSE 8000
CMD ["uvicorn", "api.main:app", "--host", "0.0.0.0", "--port", "8000"]

Frontend (Next.js + Node 22)

Location: frontend/Dockerfile

FROM node:22-alpine AS base

FROM base AS deps
RUN apk add --no-cache libc6-compat
WORKDIR /app
COPY package.json package-lock.json* ./
RUN npm ci

FROM base AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
ARG NEXT_PUBLIC_API_URL
ENV NEXT_PUBLIC_API_URL=${NEXT_PUBLIC_API_URL}
RUN npm run build

FROM base AS runner
WORKDIR /app
ENV NODE_ENV=production
RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs
COPY --from=builder /app/public ./public
COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
USER nextjs
EXPOSE 3000
ENV PORT=3000
ENV HOSTNAME="0.0.0.0"
CMD ["node", "server.js"]

---

Development Logs

Changelog (logs/changelog.md)

Records version changes in reverse chronological order using Keep a Changelog conventions.

Format:

# Changelog

## [YYYY-MM-DD]

### Added
- New features or capabilities

### Changed
- Modifications to existing functionality

### Fixed
- Bug fixes

### Removed
- Deprecated features removed

Daily Log (logs/daily/{yyyy-mm-dd}_devlog.md)

Records detailed development activities for each day.

Filename format: 2026-01-23_devlog.md

Monthly Summary (logs/monthly/{month_name}_devlog.md)

Aggregates monthly development into a high-level summary.

Filename format: December_devlog.md

Format:

# Monthly Summary - YYYY-MM

## Overview
Brief description of the month's focus and achievements.

## Key Achievements
- Achievement 1
- Achievement 2

## Architecture Changes
- Change 1
- Change 2

## Tech Stack Additions
- Technology 1 (purpose)
- Technology 2 (purpose)

---

Usage Notes

• Replace {project_name} with actual project name in docker-compose.yml
• Port 5433 is used for PostgreSQL to avoid conflicts with local installations
• Backend uses repository pattern for data access
• Frontend initialized via npx create-next-app@latest