Architecture Decision Records (ADRs)

← Home

Build New Drupal Site

Introduction

Builds a new Drupal site using Kalamuna's Drupal Project. This skill should be used when creating a new Drupal site.

Decision

This is Kalamuna's Agent Skill "Build New Drupal Site". Agent Skills enable reusable capabilities within agentic coding tools like Claude Code or OpenCode. By leveraging a skill like this, we can standardize the way coding agents function across the organization.

Context

There are two ways to install this Skill...

With Node.js:

npx skills add git@github.com:kalamuna/architecture.git --skill build-new-drupal-site
Manually
  1. Place it at ~/.claude/skills/build-new-drupal-site/SKILL.md

Source

---
name: build-new-drupal-site
description: Builds a new Drupal site using Kalamuna's Drupal Project. This skill should be used when creating a new Drupal site.
license: MIT
metadata:
  author: Rob Loach
  date: 2025-02-11
---

# Build New Drupal Site

This covers the steps required to build a new Drupal site using Kalamuna's Drupal site template.

## Dependencies

- DDEV `ddev --version`

## Quick Start

1. Get the name of the project. It should match the JIRA Project ID. For example: "SFUSD". Create a new folder by the lowercase name of the project. SFUSD would become "sfusd".
   ```sh
   mkdir myproject
   cd myproject
   ```

2. Create a new git repository, and pull the starter template into your repository
   ```sh
   git init
   git pull git@github.com:kalamuna/kala-drupal-project.git
   ```

3. Use Composer to set up the project
    ```sh
    ddev composer install
    ```

4. Update the name of the DDEV project within `.ddev/config.yaml` to the name of the folder:
   ```diff
   -name: kala-drupal-project
   +name: myproject
   ```

5. Start DDEV
   ```sh
   ddev start
   ```

6. Set up the site with DDEV
   ``` sh
   ddev drush site:install --account-name=admin --account-pass=admin -y
   ```

7. Provide a login URL
   ``` sh
   ddev drush uli
   ```

Consequences

None

Exceptions

Use this Skill where it makes sense. It is not a requirement to encorporate into all workflows.

Additional Resources

← See more ADRs