Blog

A technical, plain-language guide to agentic development, AI agent teams, governance, framework choices, real workflows, and why companies are moving from assistants to governed agents.

A plain-language guide to MCP servers, Model Context Protocol, and how AI agents connect to tools like Figma, GitHub, DevTools, docs, databases, Jira, Drive, and local…

A practical GH-600 Agentic AI Study Platform with lessons, quizzes, labs, flashcards, scenarios, and an exam simulator for GitHub Copilot, MCP, guardrails, evaluation, and responsible AI.

AI agents should not be treated as magic workers that can freely read files, call tools, change code, query systems, create pull requests, send messages, or…

Keyboard and Focus Order is the evidence area for focusable element discovery, sequential tab-stop capture, deterministic focus findings, manual verification, and exportable focus evidence. A list…

The Dashboard is the reviewer’s starting point. It tells you what was scanned, what evidence exists, whether the current page state is fresh, and what should…

Manual Checks is the review queue for checks automation cannot safely classify, including tester instructions, expected observations, selectors, and evidence requirements. This section is where the…

Language Mismatch reviews declared page language, visible mixed-language evidence, inline language signals, and confidence-bound output. Language detection can get messy quickly, especially with short labels, names,…

Scan Results is the main triage surface. It turns automated WCAG findings, responsive comparison data, and issue evidence into something a reviewer can verify and hand…

Metadata Check reviews page title, H1/title relationship, canonical URL, social preview metadata, structured data, viewport metadata, and baseline document signals. Good metadata helps people understand where…

The strict final A11Y Cat Chrome Web Store submission prompt I use to test the MV3 extension package, scanner trust, privacy, documentation, UI, and release process…

Reports, Exports, and Developer Handoff turn working evidence into material another person can read, reproduce, archive, and act on. The best accessibility report is not the…

Headings is the structure review area for ordered outline analysis, visible H1 checks, hidden or empty headings, skipped levels, duplicates, and semantic heading risks. This section…

Alt Text Analysis reviews image alternatives, decorative image evidence, context-dependent alt quality, and the limits of manual image judgement. Alt text is not just a missing-attribute…

Local History and Comparison answer a practical question: did this page get better, worse, or simply different since the last comparable scan? This is one of…

Broken Links checks visible anchors and classifies same-document, same-origin, cross-origin, valid, broken, skipped, unverified, timeout, restricted, and risky outcomes. A broken link is simple only when…

Screen Reader Review is a Guidepup-supported virtual screen-reader workspace for spoken-output evidence, structured review, diagnostics, and QA handover. The most important thing about this feature is…

What I learned while debugging an accessibility scanner with AI agents, and why evidence matters more than pass/fail theatre.

A practical look at WAVE API, axe-core, Playwright, Pa11y, IBM Equal Access, and why a local scanner is the more honest foundation for A11Y CAT.

Why I built Cat Crawler, what it is good at, what it taught me, and the improvements I would make next.

What it takes to use agents without letting the work slip into vague claims, fake certainty, or sloppy release habits.

A look at the way people are talking about WordPress and AI, and why accessibility still gets flattened or ignored in that conversation.

A plain account of where the project stands now, what it can actually prove, and where the limits still are.

Why the project started leaning harder on rules, release discipline, and explicit boundaries instead of good intentions.

Packaging, release handoff, and build cleanup stopped being side work once the project got big enough to ship properly.

This was probably inevitable. The only question was whether I was going to admit it early enough. By mid-April, A11Y Cat’s runtime had become too large…

These are the kinds of features that sound small until you try to make them useful on real pages without being annoying. Language, headings, and structure…

This was a big shift in what “tested” meant to me. There is a difference between testing that a tool runs and testing that it keeps…

A lot of the middle history is me adding more surfaces around the main scan because real review work kept asking for them. If I had…

The later AI work feels much less like “let the model help everywhere” and much more like “if AI is here, it needs to fit inside…

This is one of those engineering details that sounds boring until you realise it is protecting the truth of the whole release story. One of the…

This is one of the clearest places where the repo stopped treating failure handling as an afterthought. A lot of browser tools quietly act embarrassed when…

Once I started looking at the extension commits closely, it stopped feeling like “another way to launch the tool” and started feeling like a different phase…

This was one of those moments where the main limitation was not the audit logic. It was how the tool reached the page at all. I…

This is where the project starts moving from “run a scan now” toward “use the tool as part of an ongoing review process.” There is a…

I can see the enthusiasm in this stage, but I can also see that I had not settled the trust story yet. The first AI phase…

At first glance it looks like I got distracted by GIFs. Looking back, I think I was trying to make the tool legible. February 16 is…

At some point the output itself was no longer enough. I needed the tool to say where a result came from and how it had been…

This was one of the more important mindset changes in the whole repo, and it was not really about UI labels. It was about honesty. For…

I thought this would be one of the simpler checks. It really was not. Contrast keeps showing up in A11Y Cat’s history because it is one…

This part of the history is uncomfortable in a useful way. It shows me correcting a story that was too easy to overread. Screen reader support…

I thought this would be a cleaner refactor than it was. The history makes it pretty obvious that it was important, but not painless. Once the…

By the time I came back to AI in April, I seemed much less interested in “chat” and much more interested in keeping the tool from…

April 7 feels like the moment I stopped just adding things and started asking what I could actually prove. The commit that stands out most to…

This was one of the first moments where the project stopped feeling like a passive report and started feeling like a browser-side helper. One of the…

I do not think I realised how much product shape was already in the first version until I looked back properly. When people describe small accessibility…

I did not start by building a platform. I started by trying to make the quickest useful thing I could actually run on a page. The…

At some point I realised the release process was not just admin around the edges. It was part of the credibility of the product itself. If…

AI in accessibility can be useful, but it becomes sloppy very fast when people let it wander into judgement. I was not interested in that. I…

A finding that dies inside a panel is not worth much. Real accessibility work has to move. It gets handed to engineers, QA, delivery people, clients,…

The command surface ended up becoming one of the most practical parts of the project. Instead of one fuzzy assistant prompt box with no real boundaries,…

This matters to me a lot because accessibility tooling gets dishonest here very quickly. A product runs a scan, says something grand about screen readers, and…

I have always liked heading structure because it gives a page away almost immediately. You can tell when a page has been thought through and you…

Contrast checks are easy to make look more certain than they really are. Real pages have gradients, overlays, images, pseudo-elements, shadows, and mixed backgrounds. Once you…

People love the flashy parts of accessibility tooling, but some of the most useful checks are the ones that sound ordinary: headings, metadata, language, alt text,…

This sounds small until you have seen a tool audit itself into nonsense. The minute you inject a panel, controls, overlays, and support markup into the…

A neat list of issues is not enough for me. I wanted provenance. I wanted to know where the result came from, what checked it, what…

This was one of the biggest turning points in the build. I stopped treating every finding as if it belonged in the same bucket. That is…

One of the earliest decisions in A11Y Cat was not glamorous at all. I did not want a tool that only worked in the perfect setup.…

My WordPress theme for this site. Built on Underscores, with Sass, Local, and WooCommerce support where I need it.

A WordPress theme with Bootstrap, older front-end plugins, and a custom menu walker. Part theme build, part cleanup exercise.

A WordPress theme scaffold built on Underscores and Bootstrap. Useful when a project needs a standard set of templates quickly.

An older Jekyll portfolio site with case studies and a blog. Simple, static, and very much shaped by GitHub Pages constraints.

The repo behind my GitHub Pages portfolio. Jekyll, case studies, a blog, and the usual static-site trade-offs.

A browser tool that turns one image into a full set of print files and PDFs, without sending anything off the machine.

A browser-based reading tracker that keeps everything in localStorage. Add books, set goals, and keep notes without a backend.

Two small Express and EJS exercises: one for routing and templates, one for basic POST handling. Straightforward learning projects.

Using a percentage or a responsive unit to set the font size of the HTML element will mean that the font size will always be 100%…

A shopping cart displays important data about the product and overall order and really highlights the quality (or lack) of the client service provided by a…