ACI Pages Template

A template repository for building a GitHub Pages site that implements ACI Level 1 — the Autonomous Company Interface (ACI) standard for machine-readable organizational self-description.

Live demo: https://narko4u.github.io/aci-pages-template/

ACI Level 1 means your site publishes machine-readable identity and capability manifests so autonomous agents (AI crawlers, bots, assistants) can discover your organization and its offerings.

---

What's included

aci-pages-template/
  index.html                     # Landing page with ACI badge
  404.html                       # Custom 404 for GitHub Pages
  llms.txt                       # AI agent discovery entry point
  _config.yml                    # GitHub Pages configuration
  LICENSE                        # MIT License
  .well-known/
    aci/
      identity.json              # Organization identity manifest
      capabilities.json          # Organization capability manifest

What ACI Level 1 provides

Capability	Description
Identity	Who owns the site and their canonical identifiers
Capabilities	What products, services, or solutions the organization offers
Discovery	Standard paths agents can use to find your ACI manifests
llms.txt	AI-friendly discovery at /llms.txt

---

Quick start

1. Fork this repository

Click the Fork button at the top-right of this repo on GitHub.

2. Clone your fork

git clone https://github.com/YOUR-ORG/aci-pages-template.git
cd aci-pages-template

3. Customize identity.json

Edit .well-known/aci/identity.json and replace all YOUR-* and placeholder values:

Field	Replace with
publisher	Your legal organization name
website	Your GitHub Pages URL
description	Brief description of your organization
identifiers[].id	Your org identifier (e.g., org.acmecorp)
identifiers[].value	Your domain (e.g., acmecorp.github.io)
discovery.*	Your deployed URLs

4. Customize capabilities.json

Edit .well-known/aci/capabilities.json to reflect your site's actual offerings:

• Update or replace the services array with your own products, services, or solutions
• Update the documentation.identity-manifest URL to your deployed URL

5. Update llms.txt

Edit llms.txt — paths are relative and should work as-is on GitHub Pages.

6. Update _config.yml

Replace YOUR-ORG with your GitHub organization or username in the url and baseurl fields.

7. Push & deploy

git add .
git commit -m "Customize ACI Level 1 template"
git push origin main

Then enable GitHub Pages in your repo settings:

1. Go to Settings > Pages
2. Under Branch, select main and / (root)
3. Click Save

Your site will be live at:

https://YOUR-ORG.github.io/aci-pages-template/

---

Verifying your ACI Level 1 compliance

Once deployed, verify your site with the ACI Validator:

Or use the ACI Validator from the ACI Specification repository:

# Test identity discovery
curl https://YOUR-ORG.github.io/aci-pages-template/.well-known/aci/identity.json

# Test capabilities discovery
curl https://YOUR-ORG.github.io/aci-pages-template/.well-known/aci/capabilities.json

# Test llms.txt
curl https://YOUR-ORG.github.io/aci-pages-template/llms.txt

All three should return 200 OK with valid content.

---

Customizing beyond the template

Adding a custom domain

1. Update the url in _config.yml to your domain
2. Set baseurl to "" (empty)
3. Configure your domain in Settings > Pages on GitHub
4. Update URLs in identity.json and capabilities.json

Upgrading to ACI Level 2

ACI Level 2 adds:

• Knowledge Manifest — structured ontology of domain concepts
• Trust Manifest — attestations, certifications, patents, and evidence

See the ACI specification for details.

---

Resources

• ACI Specification
• GitHub Pages Documentation
• llms.txt Directory

---

License

This template is published under the MIT License. Free to use, modify, and distribute.