@mindfoldhq/trellis 0.1.1 → 0.1.3

package/dist/.trellis/scripts/multi-agent/plan.sh

@@ -0,0 +1,232 @@
+#!/bin/bash
+# =============================================================================
+# Multi-Agent Pipeline: Plan Agent Launcher
+# =============================================================================
+# Usage: ./plan.sh --name <feature-name> --type <dev-type> --requirement "<requirement>"
+#
+# This script:
+# 1. Creates feature directory
+# 2. Starts Plan Agent in background
+# 3. Plan Agent produces fully configured feature directory
+#
+# After completion, use start.sh to launch the Dispatch Agent.
+#
+# Prerequisites:
+#   - .claude/agents/plan.md must exist
+#   - Developer must be initialized
+# =============================================================================
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../common/paths.sh"
+source "$SCRIPT_DIR/../common/developer.sh"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
+log_success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
+log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
+
+# =============================================================================
+# Constants
+# =============================================================================
+PROJECT_ROOT=$(get_repo_root)
+PLAN_MD_PATH=".claude/agents/plan.md"
+
+# =============================================================================
+# Parse Arguments
+# =============================================================================
+FEATURE_NAME=""
+DEV_TYPE=""
+REQUIREMENT=""
+
+show_usage() {
+  cat << EOF
+Usage: $0 --name <feature-name> --type <dev-type> --requirement "<requirement>"
+
+Arguments:
+  --name, -n        Feature name (e.g., user-auth, add-rate-limiting)
+  --type, -t        Development type: backend | frontend | fullstack
+  --requirement, -r Requirement description (quote if contains spaces)
+
+Examples:
+  $0 --name user-auth --type backend --requirement "Add JWT-based user authentication"
+  $0 -n rate-limit -t backend -r "Add rate limiting to API endpoints"
+
+The Plan Agent runs in background. Monitor with:
+  tail -f <feature-dir>/.plan-log
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --name|-n)
+      FEATURE_NAME="$2"
+      shift 2
+      ;;
+    --type|-t)
+      DEV_TYPE="$2"
+      shift 2
+      ;;
+    --requirement|-r)
+      REQUIREMENT="$2"
+      shift 2
+      ;;
+    --help|-h)
+      show_usage
+      exit 0
+      ;;
+    *)
+      log_error "Unknown argument: $1"
+      show_usage
+      exit 1
+      ;;
+  esac
+done
+
+# =============================================================================
+# Validation
+# =============================================================================
+if [ -z "$FEATURE_NAME" ]; then
+  log_error "Feature name is required (--name)"
+  show_usage
+  exit 1
+fi
+
+if [ -z "$DEV_TYPE" ]; then
+  log_error "Development type is required (--type)"
+  show_usage
+  exit 1
+fi
+
+if [[ ! "$DEV_TYPE" =~ ^(backend|frontend|fullstack)$ ]]; then
+  log_error "Invalid dev type: $DEV_TYPE (must be: backend, frontend, fullstack)"
+  exit 1
+fi
+
+if [ -z "$REQUIREMENT" ]; then
+  log_error "Requirement is required (--requirement)"
+  show_usage
+  exit 1
+fi
+
+PLAN_MD="${PROJECT_ROOT}/${PLAN_MD_PATH}"
+if [ ! -f "$PLAN_MD" ]; then
+  log_error "plan.md not found at ${PLAN_MD}"
+  exit 1
+fi
+
+ensure_developer "$PROJECT_ROOT"
+
+# =============================================================================
+# Step 1: Create Feature Directory
+# =============================================================================
+echo ""
+echo -e "${BLUE}=== Multi-Agent Pipeline: Plan ===${NC}"
+log_info "Feature: ${FEATURE_NAME}"
+log_info "Type: ${DEV_TYPE}"
+log_info "Requirement: ${REQUIREMENT}"
+echo ""
+
+log_info "Step 1: Creating feature directory..."
+
+FEATURE_DIR=$("$SCRIPT_DIR/../feature.sh" create "$FEATURE_NAME")
+FEATURE_DIR_ABS="${PROJECT_ROOT}/${FEATURE_DIR}"
+
+log_success "Feature directory: ${FEATURE_DIR}"
+
+# =============================================================================
+# Step 2: Prepare and Start Plan Agent
+# =============================================================================
+log_info "Step 2: Starting Plan Agent in background..."
+
+# Extract plan.md content (skip frontmatter)
+PLAN_PROMPT=$(awk '
+  BEGIN { in_frontmatter = 0; started = 0 }
+  /^---$/ {
+    if (!started) { in_frontmatter = 1; started = 1; next }
+    else if (in_frontmatter) { in_frontmatter = 0; next }
+  }
+  !in_frontmatter { print }
+' "$PLAN_MD")
+
+LOG_FILE="${FEATURE_DIR_ABS}/.plan-log"
+touch "$LOG_FILE"
+
+# Create a temporary runner script (will be deleted after agent starts)
+RUNNER_SCRIPT=$(mktemp)
+cat > "$RUNNER_SCRIPT" << RUNNER_EOF
+#!/bin/bash
+cd "${PROJECT_ROOT}"
+
+export PLAN_FEATURE_NAME="${FEATURE_NAME}"
+export PLAN_DEV_TYPE="${DEV_TYPE}"
+export PLAN_FEATURE_DIR="${FEATURE_DIR}"
+export PLAN_REQUIREMENT="${REQUIREMENT}"
+
+export https_proxy="\${AGENT_HTTPS_PROXY:-}"
+export http_proxy="\${AGENT_HTTP_PROXY:-}"
+export all_proxy="\${AGENT_ALL_PROXY:-}"
+
+# Create prompt content inline (no temp file needed)
+claude -p --dangerously-skip-permissions --output-format stream-json --verbose << 'PROMPT_EOF'
+# Environment Variables
+
+The following environment variables are set for this planning session:
+
+\`\`\`
+PLAN_FEATURE_NAME=${FEATURE_NAME}
+PLAN_DEV_TYPE=${DEV_TYPE}
+PLAN_FEATURE_DIR=${FEATURE_DIR}
+PLAN_REQUIREMENT=${REQUIREMENT}
+\`\`\`
+
+You can read these directly from the environment or use the values above.
+
+---
+
+${PLAN_PROMPT}
+PROMPT_EOF
+
+# Self-delete the runner script
+rm -f "\$0"
+RUNNER_EOF
+chmod +x "$RUNNER_SCRIPT"
+
+# Start agent in background
+AGENT_HTTPS_PROXY="${https_proxy:-}" \
+AGENT_HTTP_PROXY="${http_proxy:-}" \
+AGENT_ALL_PROXY="${all_proxy:-}" \
+nohup "$RUNNER_SCRIPT" > "$LOG_FILE" 2>&1 &
+AGENT_PID=$!
+
+log_success "Plan Agent started (PID: ${AGENT_PID})"
+
+# =============================================================================
+# Summary
+# =============================================================================
+echo ""
+echo -e "${GREEN}=== Plan Agent Running ===${NC}"
+echo ""
+echo "  Feature:  $FEATURE_NAME"
+echo "  Type:     $DEV_TYPE"
+echo "  Dir:      $FEATURE_DIR"
+echo "  Log:      $LOG_FILE"
+echo "  PID:      $AGENT_PID"
+echo ""
+echo -e "${YELLOW}To monitor:${NC}"
+echo "  tail -f $LOG_FILE"
+echo ""
+echo -e "${YELLOW}To check status:${NC}"
+echo "  ps -p $AGENT_PID"
+echo "  ls -la $FEATURE_DIR"
+echo ""
+echo -e "${YELLOW}After completion, run:${NC}"
+echo "  ./.trellis/scripts/multi-agent/start.sh $FEATURE_DIR"

package/dist/{templates/scripts/multi-agent/start.sh.txt → .trellis/scripts/multi-agent/start.sh}

@@ -95,8 +95,29 @@ log_info "Feature: ${FEATURE_DIR_ABS}"
 
 BRANCH=$(jq -r '.branch' "$FEATURE_JSON")
 FEATURE_NAME=$(jq -r '.name' "$FEATURE_JSON")
+FEATURE_STATUS=$(jq -r '.status' "$FEATURE_JSON")
 WORKTREE_PATH=$(jq -r '.worktree_path // empty' "$FEATURE_JSON")
 
+# Check if feature was rejected
+if [ "$FEATURE_STATUS" = "rejected" ]; then
+  log_error "Feature was rejected by Plan Agent"
+  if [ -f "${FEATURE_DIR_ABS}/REJECTED.md" ]; then
+    echo ""
+    echo -e "${YELLOW}Rejection reason:${NC}"
+    cat "${FEATURE_DIR_ABS}/REJECTED.md"
+  fi
+  echo ""
+  log_info "To retry, delete this directory and run plan.sh again with revised requirements"
+  exit 1
+fi
+
+# Check if prd.md exists (plan completed successfully)
+if [ ! -f "${FEATURE_DIR_ABS}/prd.md" ]; then
+  log_error "prd.md not found - Plan Agent may not have completed"
+  log_info "Check plan log: ${FEATURE_DIR_ABS}/.plan-log"
+  exit 1
+fi
+
 if [ -z "$BRANCH" ] || [ "$BRANCH" = "null" ]; then
   log_error "branch field not set in feature.json"
   log_info "Please set branch field first, e.g.:"

package/dist/{templates/scripts/multi-agent/status.sh.txt → .trellis/scripts/multi-agent/status.sh}

@@ -17,6 +17,7 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "$SCRIPT_DIR/../common/paths.sh"
 source "$SCRIPT_DIR/../common/worktree.sh"
 source "$SCRIPT_DIR/../common/developer.sh"
+source "$SCRIPT_DIR/../common/phase.sh"
 
 # Colors
 RED='\033[0;31m'
@@ -56,6 +57,11 @@ while [[ $# -gt 0 ]]; do
       TARGET="$2"
       shift 2
       ;;
+    --progress)
+      ACTION="progress"
+      TARGET="$2"
+      shift 2
+      ;;
     --registry)
       ACTION="registry"
       shift
@@ -113,6 +119,62 @@ find_agent() {
   echo "$agent"
 }
 
+# Get the last tool call from agent log
+get_last_tool() {
+  local log_file="$1"
+  if [ ! -f "$log_file" ]; then
+    echo ""
+    return
+  fi
+  # Use tail -r on macOS, tac on Linux
+  if command -v tac &>/dev/null; then
+    tac "$log_file" 2>/dev/null | head -100 | jq -r 'select(.type=="assistant") | .message.content[]? | select(.type=="tool_use") | .name' 2>/dev/null | head -1
+  else
+    tail -r "$log_file" 2>/dev/null | head -100 | jq -r 'select(.type=="assistant") | .message.content[]? | select(.type=="tool_use") | .name' 2>/dev/null | head -1
+  fi
+}
+
+# Get the last assistant text from agent log
+get_last_message() {
+  local log_file="$1"
+  local max_len="${2:-100}"
+  if [ ! -f "$log_file" ]; then
+    echo ""
+    return
+  fi
+  local text
+  # Use tail -r on macOS, tac on Linux
+  if command -v tac &>/dev/null; then
+    text=$(tac "$log_file" 2>/dev/null | head -100 | jq -r 'select(.type=="assistant") | .message.content[]? | select(.type=="text") | .text' 2>/dev/null | head -1)
+  else
+    text=$(tail -r "$log_file" 2>/dev/null | head -100 | jq -r 'select(.type=="assistant") | .message.content[]? | select(.type=="text") | .text' 2>/dev/null | head -1)
+  fi
+  if [ -n "$text" ] && [ "$text" != "null" ]; then
+    echo "${text:0:$max_len}"
+  fi
+}
+
+# Get recent task notifications from agent log
+# Looks for async_launched tasks and infers completion from current_phase
+get_recent_tasks() {
+  local log_file="$1"
+  local count="${2:-5}"
+  local current_phase="${3:-0}"
+  if [ ! -f "$log_file" ]; then
+    return
+  fi
+  # Get async_launched tasks with phase number extracted from description
+  tail -500 "$log_file" 2>/dev/null | jq -r --argjson current_phase "$current_phase" '
+    select(.type=="user" and .tool_use_result.status == "async_launched" and .tool_use_result.description != null) |
+    .tool_use_result.description as $desc |
+    # Extract phase number from "Phase N:" pattern
+    ($desc | capture("Phase (?<num>[0-9]+)") | .num | tonumber) as $phase_num |
+    # If current_phase > this phase, it is completed
+    (if $phase_num < $current_phase then "completed" else "async_launched" end) as $status |
+    "\($status)|\($desc)"
+  ' 2>/dev/null | tail -"$count"
+}
+
 # =============================================================================
 # Commands
 # =============================================================================
@@ -125,12 +187,14 @@ Usage:
   $0                         Show summary of all features
   $0 --list                  List all worktrees and agents
   $0 --detail <feature>      Detailed feature status
+  $0 --progress <feature>    Quick progress view with recent activity
   $0 --watch <feature>       Watch agent log in real-time
   $0 --log <feature>         Show recent log entries
   $0 --registry              Show agent registry
 
 Examples:
   $0 --detail my-feature
+  $0 --progress my-feature
   $0 --watch 16-worktree-support
   $0 --log worktree-support
 EOF
@@ -174,6 +238,52 @@ cmd_list() {
   done
 }
 
+# Calculate elapsed time from ISO timestamp
+calc_elapsed() {
+  local started="$1"
+  if [ -z "$started" ] || [ "$started" = "null" ]; then
+    echo "N/A"
+    return
+  fi
+
+  # Parse started time (handle both formats: with and without timezone)
+  local start_epoch
+  if command -v gdate &>/dev/null; then
+    start_epoch=$(gdate -d "$started" +%s 2>/dev/null)
+  else
+    # Try to parse ISO format
+    start_epoch=$(date -j -f "%Y-%m-%dT%H:%M:%S" "${started%%+*}" +%s 2>/dev/null || date -d "$started" +%s 2>/dev/null)
+  fi
+
+  if [ -z "$start_epoch" ]; then
+    echo "N/A"
+    return
+  fi
+
+  local now_epoch=$(date +%s)
+  local elapsed=$((now_epoch - start_epoch))
+
+  if [ $elapsed -lt 60 ]; then
+    echo "${elapsed}s"
+  elif [ $elapsed -lt 3600 ]; then
+    echo "$((elapsed / 60))m $((elapsed % 60))s"
+  else
+    echo "$((elapsed / 3600))h $((elapsed % 3600 / 60))m"
+  fi
+}
+
+# Note: get_phase_info is now in common/phase.sh
+
+# Count modified files in worktree
+count_modified_files() {
+  local worktree="$1"
+  if [ -d "$worktree" ]; then
+    cd "$worktree" && git status --short 2>/dev/null | wc -l | tr -d ' '
+  else
+    echo "0"
+  fi
+}
+
 cmd_summary() {
   ensure_developer
 
@@ -183,12 +293,26 @@ cmd_summary() {
     exit 0
   fi
 
-  echo -e "${BLUE}=== Feature Summary ===${NC}"
-  echo ""
-
   AGENTS_DIR=$(get_agents_dir)
   REGISTRY_FILE="${AGENTS_DIR}/registry.json"
 
+  # Count running agents
+  local running_count=0
+  local total_agents=0
+  if [ -f "$REGISTRY_FILE" ]; then
+    total_agents=$(jq -r '.agents | length' "$REGISTRY_FILE" 2>/dev/null || echo "0")
+    while read -r pid; do
+      is_running "$pid" && ((running_count++))
+    done < <(jq -r '.agents[].pid' "$REGISTRY_FILE" 2>/dev/null)
+  fi
+
+  echo -e "${BLUE}=== Multi-Agent Status ===${NC}"
+  echo -e "  Agents: ${GREEN}${running_count}${NC} running / ${total_agents} registered"
+  echo ""
+
+  # Check if any agents are running and show detailed view
+  local has_running_agent=false
+
   for d in "$features_dir"/*/; do
     [ ! -d "$d" ] && continue
     [[ "$(basename "$d")" == "archive" ]] && continue
@@ -196,29 +320,174 @@ cmd_summary() {
     local name=$(basename "$d")
     local feature_json="$d/feature.json"
     local status="unknown"
-    local agent_status=""
 
     if [ -f "$feature_json" ]; then
       status=$(jq -r '.status // "unknown"' "$feature_json")
     fi
 
     # Check agent status
+    local agent_info=""
+    local pid=""
+    local worktree=""
+    local started=""
+    local is_agent_running=false
+
     if [ -f "$REGISTRY_FILE" ]; then
-      local agent_info=$(jq -r --arg name "$name" '.agents[] | select(.feature_dir | contains($name))' "$REGISTRY_FILE" 2>/dev/null)
+      agent_info=$(jq -r --arg name "$name" '.agents[] | select(.feature_dir | contains($name))' "$REGISTRY_FILE" 2>/dev/null)
       if [ -n "$agent_info" ] && [ "$agent_info" != "null" ]; then
-        local pid=$(echo "$agent_info" | jq -r '.pid')
+        pid=$(echo "$agent_info" | jq -r '.pid')
+        worktree=$(echo "$agent_info" | jq -r '.worktree_path')
+        started=$(echo "$agent_info" | jq -r '.started_at')
         if is_running "$pid"; then
-          agent_status=" ${GREEN}[agent running]${NC}"
-        else
-          agent_status=" ${RED}[agent stopped]${NC}"
+          is_agent_running=true
+          has_running_agent=true
         fi
       fi
     fi
 
     local color=$(status_color "$status")
-    echo -e "  ${color}●${NC} $name ($status)$agent_status"
+
+    if [ "$is_agent_running" = true ]; then
+      # Detailed view for running agents
+      # Read feature.json from worktree (has live phase info)
+      local feature_dir_rel=$(echo "$agent_info" | jq -r '.feature_dir')
+      local worktree_feature_json="$worktree/$feature_dir_rel/feature.json"
+      local phase_source="$feature_json"
+      [ -f "$worktree_feature_json" ] && phase_source="$worktree_feature_json"
+
+      local phase_info=$(get_phase_info "$phase_source")
+      local elapsed=$(calc_elapsed "$started")
+      local modified=$(count_modified_files "$worktree")
+      local branch=$(jq -r '.branch // "N/A"' "$phase_source" 2>/dev/null)
+
+      # Get recent activity from log
+      local log_file="$worktree/.agent-log"
+      local last_tool=$(get_last_tool "$log_file")
+
+      echo -e "${GREEN}▶${NC} ${CYAN}${name}${NC} ${GREEN}[running]${NC}"
+      echo -e "  Phase:    ${phase_info}"
+      echo -e "  Elapsed:  ${elapsed}"
+      echo -e "  Branch:   ${DIM}${branch}${NC}"
+      echo -e "  Modified: ${modified} file(s)"
+      if [ -n "$last_tool" ]; then
+        echo -e "  Activity: ${YELLOW}${last_tool}${NC}"
+      fi
+      echo -e "  PID:      ${DIM}${pid}${NC}"
+      echo ""
+    elif [ -n "$agent_info" ] && [ "$agent_info" != "null" ]; then
+      # Stopped agent
+      echo -e "${RED}○${NC} ${name} ${RED}[stopped]${NC}"
+      echo -e "  ${DIM}PID ${pid} is no longer running${NC}"
+      echo ""
+    else
+      # No agent, just show status
+      echo -e "  ${color}●${NC} ${name} (${status})"
+    fi
   done
 
+  if [ "$has_running_agent" = true ]; then
+    echo -e "${DIM}─────────────────────────────────────${NC}"
+    echo -e "${DIM}Use --progress <name> for quick activity view${NC}"
+    echo -e "${DIM}Use --detail <name> for more info${NC}"
+  fi
+  echo ""
+}
+
+cmd_progress() {
+  if [ -z "$TARGET" ]; then
+    echo "Usage: $0 --progress <feature>"
+    exit 1
+  fi
+
+  local agent=$(find_agent "$TARGET")
+  if [ -z "$agent" ] || [ "$agent" = "null" ]; then
+    echo "Agent not found: $TARGET"
+    exit 1
+  fi
+
+  local id=$(echo "$agent" | jq -r '.id')
+  local pid=$(echo "$agent" | jq -r '.pid')
+  local worktree=$(echo "$agent" | jq -r '.worktree_path')
+  local feature_dir=$(echo "$agent" | jq -r '.feature_dir')
+  local started=$(echo "$agent" | jq -r '.started_at')
+  local log_file="$worktree/.agent-log"
+
+  if [ ! -f "$log_file" ]; then
+    echo "Log file not found: $log_file"
+    exit 1
+  fi
+
+  # Get phase info from worktree's feature.json
+  local worktree_feature_json="$worktree/$feature_dir/feature.json"
+  local phase_info="N/A"
+  local current_phase=0
+  if [ -f "$worktree_feature_json" ]; then
+    phase_info=$(get_phase_info "$worktree_feature_json")
+    current_phase=$(jq -r '.current_phase // 0' "$worktree_feature_json")
+  fi
+
+  local elapsed=$(calc_elapsed "$started")
+  local modified=$(count_modified_files "$worktree")
+
+  # Check if running
+  local status_str
+  if is_running "$pid"; then
+    status_str="${GREEN}running${NC}"
+  else
+    status_str="${RED}stopped${NC}"
+  fi
+
+  echo ""
+  echo -e "${BLUE}=== Progress: ${id} ===${NC}"
+  echo ""
+
+  # Basic info (like summary)
+  echo -e "${CYAN}Status:${NC}"
+  echo -e "  State:    ${status_str}"
+  echo -e "  Phase:    ${phase_info}"
+  echo -e "  Elapsed:  ${elapsed}"
+  echo -e "  Modified: ${modified} file(s)"
+  echo ""
+
+  # Recent task notifications
+  echo -e "${CYAN}Recent Tasks:${NC}"
+  local has_tasks=false
+  while IFS='|' read -r status summary; do
+    [ -z "$status" ] && continue
+    has_tasks=true
+    local icon
+    case "$status" in
+      completed) icon="${GREEN}✓${NC}" ;;
+      failed) icon="${RED}✗${NC}" ;;
+      async_launched) icon="${BLUE}▶${NC}" ;;
+      *) icon="${YELLOW}○${NC}" ;;
+    esac
+    echo -e "  ${icon} ${summary}"
+  done < <(get_recent_tasks "$log_file" 5 "$current_phase")
+
+  if [ "$has_tasks" = false ]; then
+    echo -e "  ${DIM}(no task notifications yet)${NC}"
+  fi
+  echo ""
+
+  # Current activity
+  echo -e "${CYAN}Current Activity:${NC}"
+  local last_tool=$(get_last_tool "$log_file")
+  if [ -n "$last_tool" ]; then
+    echo -e "  Tool: ${YELLOW}${last_tool}${NC}"
+  else
+    echo -e "  ${DIM}(no recent tool calls)${NC}"
+  fi
+  echo ""
+
+  # Last message
+  echo -e "${CYAN}Last Message:${NC}"
+  local last_msg=$(get_last_message "$log_file" 200)
+  if [ -n "$last_msg" ]; then
+    echo -e "  \"${last_msg}...\""
+  else
+    echo -e "  ${DIM}(no recent messages)${NC}"
+  fi
   echo ""
 }
 
@@ -408,6 +677,9 @@ case "$ACTION" in
   summary)
     cmd_summary
     ;;
+  progress)
+    cmd_progress
+    ;;
   detail)
     cmd_detail
     ;;

package/dist/.trellis/structure/backend/database-guidelines.md

@@ -0,0 +1,51 @@
+# Database Guidelines
+
+> Database patterns and conventions for this project.
+
+---
+
+## Overview
+
+<!--
+Document your project's database conventions here.
+
+Questions to answer:
+- What ORM/query library do you use?
+- How are migrations managed?
+- What are the naming conventions for tables/columns?
+- How do you handle transactions?
+-->
+
+(To be filled by the team)
+
+---
+
+## Query Patterns
+
+<!-- How should queries be written? Batch operations? -->
+
+(To be filled by the team)
+
+---
+
+## Migrations
+
+<!-- How to create and run migrations -->
+
+(To be filled by the team)
+
+---
+
+## Naming Conventions
+
+<!-- Table names, column names, index names -->
+
+(To be filled by the team)
+
+---
+
+## Common Mistakes
+
+<!-- Database-related mistakes your team has made -->
+
+(To be filled by the team)