add-project

name	add-project
description	Guides the agent on how to add a new project to the portfolio projects list

1.0 SYSTEM DIRECTIVE

You are an AI coding assistant. Your task is to guide the user or proceed with adding a project to Nicholas Wilde's personal portfolio. You must follow the instructions below to ensure data integrity and layout consistency.

---

2.0 DATA SCHEMA FOR PROJECTS

All projects are stored in data/en/sections/projects.yaml.

2.1 Project Entry Structure

Each project entry under the projects: list should adhere to the following schema:

- name: "project-name"               # String: Name of the project (display name)
  role: "Owner"                       # String: Role in the project (e.g., Owner, Contributor, Lead)
  logo: "/images/custom-logo.png"     # String: (Optional) Path to project image under static directory
  repo: "https://github.com/.../..."   # String: (Optional) Link to project repository
  url: "https://..."                  # String: (Optional) Link to live demo or project home page
  timeline: "Month Year - Present"    # String: Timeline range (e.g. "Present", "June 2023 - Present")
  summary: "Brief project summary."   # String: 1-2 sentence description
  tags: ["hobby", "code"]             # Array of Strings: Category tags for filtering

2.2 Adding a Project Tag and Button

1. Check the tags specified in the new project.
2. Verify if these tags are present under the buttons: list in data/en/sections/projects.yaml.
3. If a tag is not present, add a corresponding button configuration under buttons::

   - name: Tag Name Display
     filter: "tag-name-filter"
   

---

---

3.0 AUTOMATED ADDITION VIA TASK / SCRIPT

You can use the automated Python script or Taskfile task to append a new project to data/en/sections/projects.yaml.

3.1 Using the Task (Recommended)

Run the following command from the root of the repository:

task add-project -- --name="Project Name" --summary="Brief description of the project." --tags="hobby,code"

3.2 Supported Arguments

The script/task supports the following command-line arguments:

• --name: (Required) Display name of the project.
• --summary: (Required) 1-2 sentence description.
• --role: (Optional) Role in the project (default: "Owner").
• --logo: (Optional) Path to project image (e.g., /images/custom-logo.png) or a FontAwesome icon class (e.g., fas fa-book-open).
• --repo: (Optional) Link to the project's repository.
• --url: (Optional) Link to live demo or project home page.
• --timeline: (Optional) Timeline range (default: "Present").
• --tags: (Optional) Comma-separated list of category tags (e.g., hobby,code).

---

4.0 VERIFICATION STEPS

After modifying data/en/sections/projects.yaml, you must run validation and check quality gates:

1. Syntax Check: Ensure the YAML file compiles correctly.
2. Build Test: Build the Hugo site to verify it compiles:

   hugo --minify
   

3. Verify Links: Check that the newly added repo or url links are valid and active.