Living Whitepaper

An open source experiment tracking how generative AI is used across Aotearoa New Zealand. The repository contains two parts:

• src/livingwp – the Python code for an LLM agent that gathers research and writes updates.
• src/website – a Jekyll site that is automatically populated with those updates and served on GitHub Pages.

Contributing

We welcome contributions from the community! There are two main ways you can get involved:

• Open a Pull Request: If you want to make direct edits to the code or documentation, please fork the repository and open a Pull Request with your changes. This includes updates to the agent logic, website, or any other part of the project.

• Open an Issue: If you have suggestions, ideas, or have found a bug, feel free to open an Issue. This is a great way to propose new features, report problems, or discuss improvements.

Editing the Research Prompt

The default prompt that guides the research agent is defined in src/livingwp/prompts/instructions_research.md. You can suggest changes to this prompt by either:

• Opening a Pull Request directly with your proposed edits to the prompt file.
• Opening an Issue to discuss or suggest changes to the prompt.

Industries, prompts and models

The settings for each industry are defined in src/livingwp/config/industries.json. Changing these settings allows you to:

• Add a new industry. A new article will be created and added to the site the next time the update process runs.
• Specify which OpenAI model to use for an industry.
• Add a new instructions file to src/livingwp/prompts/ and use it to prompt the research agent for a specifc industry

We look forward to your contributions!

Process

flowchart TD
    A[Run Update Task<br/>on Schedule] --> B{Check for<br/>Existing Article}

    B -->|Article Found| C1[Run Deep Research Agent<br/>Topic + Previous Article]
    B -->|No Article| C2[Run Deep Research Agent<br/>Topic Only]

    C1 --> D[Update Article<br/>with Research Results]
    C2 --> D

    D --> E[Commit Changes]

    E -->     F[Open PR<br/>for Review]

    F --> G{Human Review}

    G -->|Needs Edits| H[Human Makes Edits<br/>to PR]
    G -->|Approve| I[Merge PR]

    H --> G

    I --> J[GitHub Action<br/>Auto Deploy to Website]

    J --> K[End]

Loading

Development

Requirements

• uv for Python dependencies
• Ruby and Bundler for running the website locally

Running the Agent

1. Install Python dependencies:

   uv sync

2. Run the agent:

   uv run livingwp

Running the command above now iterates over each markdown file in src/website/whitepaper/content, rewriting it with the latest research using the agent pipeline.

You can also target specifc industries by passing the industry slugs as arguments. For example, to update only the finance and banking article:

uv run livingwp finance banking

Working on the Website

1. Change to the site directory:

   cd src/website

2. Install Ruby gems:

   bundle install

3. Serve the site locally:

   bundle exec jekyll serve

The site will be available at http://localhost:4000 by default.