AGENTS.md - Way Into AI

AGENTS.md - Way Into AI

AGENTS.md - Way Into AI

This is a practical guide and knowledge base for documenting AI coding agents, tools, and related topics.

When Adding Entries

Before doing any work, read SKILL.md to understand the repository structure and patterns.

Quick Workflow

  1. Read SKILL.md — first time working in this repo
  2. Decide: Full reference entry or simple log?
  3. Create ref entry (if applicable):
    • Frontmatter with created: YYYY-MM-DD (today's date)
    • Screenshot at top using screenshotit.app for any web content
    • Follow structure in SKILL.md
  4. Add log entry: 1-2 sentences in logs/YYYY-MM-DD.md
  5. Pull, commit, push: 
    cd ~/src/datopian/wayintoai
git pull --rebase
git add ref/ logs/
git commit -m "Add: [Topic]"
git push

Critical Rules

Screenshots

ALWAYS include a screenshot at the top of ref entries for web content:

![Topic](https://screenshotit.app/https://example.com/url)

Place immediately after title/tagline, before Links section.

Log Entries

Maximum 1-2 sentences. Concise over comprehensive.

Log Entry H1 Titles

Every log file must have an H1 title in the format: # yyyy-mm-dd {Short Title}

  • The date comes from the filename
  • The title should be a brief, meaningful summary (3-8 words)
  • This ensures entries are recognizable when listed on the website

Every log file must also have date: YYYY-MM-DD in its frontmatter so Flowershow can sort the log listing newest-first. The date must match the filename.

Blog Posts

Every blog post in posts/ (excluding posts/index.md) must begin with:

---
title: A concise post title
description: A one-sentence summary used in listings and social metadata.
date: YYYY-MM-DD
---
  • The date must match the date prefix in the filename.
  • Do not repeat the title as an H1 in the body. Flowershow renders the frontmatter title as the page title.
  • Start the body with the opening paragraph, tagline, or screenshot as appropriate.
  • Keep title, description, and date accurate because the homepage and posts/index.md use them to render and sort post listings.

Frontmatter

Every ref entry needs:

---
created: YYYY-MM-DD  # Date added to repo (required)
author: Author Name
tags: [tag1, tag2, tag3]
---

Repository Structure

wayintoai/
├── ref/            # Full reference entries
├── logs/           # Daily logs (1-2 sentence summaries)
│   └── index.md    # Flowershow log listing
├── posts/          # Long-form articles with title/description/date frontmatter
│   └── index.md    # Flowershow post listing
├── SKILL.md        # Comprehensive guide (READ THIS)
└── AGENTS.md       # This file

See SKILL.md for Details

  • File naming conventions
  • Content structure
  • Screenshot placement and examples
  • Frontmatter requirements
  • Git workflow
  • Common patterns
  • Quality standards
  • Troubleshooting

Don't work from memory. Read SKILL.md when adding entries.

Edit this page