AI-Practitioner

jMM's AI Practitioner Blog

Maintaining the Blog

Structure

• jekyll-src/: Jekyll source files (edit here)
  • _posts/: Blog posts in Markdown format
  • _config.yml: Site configuration
  • index.md, about.md: Page content
• docs/: Generated static HTML (served via GitHub Pages)

Creating a New Post

1. Create a new Markdown file in jekyll-src/_posts/ with the naming format:

   YYYY-MM-DD-your-post-title.md
   

2. Add front matter at the top of the file:

   ---
   layout: post
   title: "Your Post Title"
   date: YYYY-MM-DD HH:MM:SS +0000
   categories: [category1, category2]
   ---

3. Write your content in Markdown below the front matter.

Building the Site

1. Navigate to the Jekyll source directory:

   cd jekyll-src

2. Install dependencies (first time only):

   bundle install

3. Build the site:

   bundle exec jekyll build --destination ../docs

4. Preview locally (optional):

   bundle exec jekyll serve

   Visit http://localhost:4000 in your browser.

---

cd jekyll-src
bundle install
bundle exec jekyll build --destination ../docs
git add jekyll-src/ docs/
git commit -m "Transfer repo to j0hnnymiller"
git push origin main

---

Publishing Changes

1. Build the site using the command above

2. Commit both source and generated files:

   git add jekyll-src/ docs/
   git commit -m "Add new post: [post title]"
   git push origin main

3. GitHub Pages will automatically serve the updated content from the docs/ folder.

Editing Existing Content

• Posts: Edit files in jekyll-src/_posts/
• Pages: Edit index.md, about.md, etc. in jekyll-src/
• Styles: Edit jekyll-src/assets/css/style.css (or theme-specific CSS)
• Configuration: Edit jekyll-src/_config.yml

After making changes, rebuild the site and commit both source and generated files.

Tips

• Always edit source files in jekyll-src/, never directly in docs/
• Test locally before pushing to ensure everything looks correct
• Keep the Jekyll version and dependencies up to date with bundle update

GitHub Multi-Account Setup

This repository includes tools for managing multiple GitHub accounts:

• GITHUB_ACCOUNTS_SETUP.md: Comprehensive setup guide for three GitHub accounts
• scripts/github-setup.ps1: PowerShell script for managing SSH keys and testing connections

Quick Setup Commands

# Show SSH public keys to add to GitHub accounts
.\scripts\github-setup.ps1 -Action show-keys

# Test all GitHub connections
.\scripts\github-setup.ps1 -Action test-connections

# Configure git settings for current repository
.\scripts\github-setup.ps1 -Action setup-git-configs

Copilot Custom Agents

• .github/agents/blog-author.agent.md: Repository-scoped custom agent for drafting and refining AIAGSD-style technical blog content.

Copilot Prompts

• .github/prompts/create-blog-section.prompt.md: Reusable prompt to generate or revise a single AIAGSD-style blog section with explicit constraints and scope.

CODE Publication Copies

• CODE/2026-04-17-AIAGSD7.md: CODE Magazine publication copy of AIAGSD Part 7 with CODE links/contact details preserved for publication workflow.
• CODE/2026-04-23-AIAGSD8.md: CODE Magazine publication copy of AIAGSD Part 8 covering the first implementation wave, starting with the shared kernel and foundational reference-data slices. AI log
• CODE/2026-06-28-AIAGSD9.md: CODE Magazine publication copy of AIAGSD Part 9 implementing the ManageRanks reference-data slice for canonical rank codes and access-level mappings.
• CODE/2026-07-27-AIAGSD10.md: CODE Magazine publication copy of AIAGSD Part 10 describing how the ManageDegrees implementation prompt establishes a durable reference-data slice for downstream academic workflows.