Moha

Taming the Unpredictable: How an AGENTS.md File Keeps Your AI Team in Check

Sat, 30 May 2026 00:00:00 +0000

Building software with a team of AI agents feels a bit like managing a group of incredibly eager, brilliant, but wildly unpredictable junior developers. They work at lightning speed and possess vast knowledge, but left to their own devices, they tend to lose the plot. Give an agent a simple feature request, and without strict boundaries, it might try to rewrite your entire frontend or introduce a massive relational database you don’t need.

I recently hit this friction point while building Pouta CMS. Because Pouta relies strictly on a serverless architecture within the Cloudflare ecosystem—specifically leveraging Pages, R2 storage, and Worker AI—there is zero room for architectural drift. Furthermore, maintaining the boundary between the GPLv3 open-source core and the SaaS Pro tier is critical.

I needed a way to dictate exactly how my Lean AI team interacts with the repository. The solution was surprisingly simple: an AGENTS.md file.

Dictating the Machine

An AGENTS.md file acts as the single source of truth for any AI agent touching your codebase. Think of it as the ultimate onboarding document. When an agent enters the repository, it reads this file to understand the hard technical constraints, the formatting standards, and the architectural philosophy of the project.

However, writing a comprehensive rulebook manually is tedious and prone to human oversight. Instead of writing it myself, I decided to let the machine dictate to the machine.

Generating the Rules with `agy`

To create the perfect AGENTS.md, I used Antigravity (agy). The premise was straightforward: an AI agent is only as good as its context.

Instead of typing out isolated instructions, I fed agy my existing, carefully crafted documentation. I provided:

My input on the desired workflow.
*The **README.md (The *What and the Why of Pouta CMS).
*The **ARCHITECTURE.md (The *How—detailing the strict serverless approach). By synthesizing these documents, agy grasped the exact boundary conditions of the project. It understood that we don’t just write code; we write code specifically optimized for Cloudflare workers and R2. It understood the separation of concerns between the open-source and premium tiers.

What Actually Goes Into `AGENTS.md`?

The resulting file generated by agy established non-negotiable rules for the rest of my Lean AI team. While the specifics are tailored deeply to Pouta, the core directives look something like this:

Infrastructure Supremacy: All storage solutions must default to Cloudflare R2. Do not suggest or implement traditional relational databases or alternative cloud providers. License Awareness: Any code modifications must respect the GPLv3 license of the core project. Features designated for the SaaS tier must be cleanly separated and not leaked into the open-source repository. Lean Execution: Do not introduce heavy external dependencies unless absolutely necessary. Rely on native web APIs and serverless patterns.

The Result: A Calibrated SDLC

Implementing AGENTS.md completely transformed my Software Development Life Cycle.

The immediate benefit was a drastic reduction in AI hallucinations. I no longer have to spend my mental energy micromanaging the agents’ architectural choices. When I ask an agent to draft a new content management feature, it inherently knows to hook it up to R2 storage rather than asking me how I want to store the data.

Treating your AI agents like a real engineering team means providing them with the structural context they need to succeed. By using agy to synthesize my project’s architecture into an AGENTS.md file, my Lean AI team is finally pulling in the exact same direction.

The Ultimate Zero-Friction Blogging Experience: Pouta and Jekyll's Perfect Pairing

Thu, 28 May 2026 00:00:00 +0000

There is no feeling quite like building a tool from scratch, plugging it into your own workflow, and watching it completely exceed your expectations. Yesterday, I officially finished building Pouta headless CMS. Today, I paired it with Jekyll for my own blog, and I am absolutely blown away.

When you build a headless CMS, you have a vision of how it should work. Seeing it actually deliver that reality in less than 24 hours is a massive win. Here is why I am incredibly hyped:

⚡ Unbelievable Speed

By pairing Pouta’s streamlined API delivery with Jekyll’s static site generation, the performance is unreal. There are no heavy databases dragging things down or clunky queries holding back load times.

The site doesn’t just load fast; it instantly snaps into existence.
Lightweight, optimized, and built for modern web performance.

✍️ Zero-Friction Blogging

I built Pouta because I wanted a cleaner way to manage content, but using it with Jekyll has made blogging feel effortless.

“The distance between having an idea and seeing it live on my site is now practically zero.”

The interface gives me a distraction-free environment to just write. Pouta handles the content architecture beautifully, hands it off to Jekyll, and the deployment is seamless. No clunky visual editors, no formatting nightmares—just pure creation.

🛠️ The Ultimate Developer High

There is a unique satisfaction in using your own tool to solve your own problems. No more fighting bloated, plugin-heavy legacy systems. This setup is secure by default, infinitely scalable, and exactly as lean as I wanted it to be.

The Verdict: Building Pouta was worth every single line of code. Seeing it make my own writing workflow this fast and this much fun is the ultimate validation. The headless future is here, and I’m proud to have built a piece of it!

Sri Lankan style Chinese fried rice recipe

Sun, 16 Nov 2014 22:37:14 +0000

Ingredients

Chicken

400g of chicken cut into small pieces (kana)
1 red chilli thinly sliced (punainen chili)
1/2 tea spoon of baking soda (ruokasoodaa)
1 tea spoons of salt (suolaa)
1 tea spoon of corn flour (maissijauhoa)
1 table spoons of cooking oil (rypsiöljy)
1 tea spoon of Indonesian sweet soy sauce (ketjap manis)
1/2 tea spoon of ginger crushed or thinly sliced (inkivääri)
1 cloves of garlic crushed or thinly sliced (valkosipuli)

Rice

3 dl of basmati or jasmine rice (basmati tai jasmiini riisi)
6 dl of water (vesi)
1 tea spoon of chicken concentrate (kana fondi)

Eggs

4 eggs (kananmuna)
2 tea spoons of pepper (pippuri)
1 tea spoon of salt (suolaa)
1 table spoons of cooking oil (rypsiöljy)

Stir fry

2 table spoons of cooking oil (rypsiöljy)
1/2 tea spoon of ginger crushed or thinly sliced (inkivääri)
1 cloves of garlic crushed or thinly sliced (valkosipuli)
2 large carrots cut Julienne (porkkana)
1 thin leek sliced (purjosipuli)
2 tea spoons of salty soy sauce (soijakastike)
1 tea spoon of salt if needed to taste (suolaa)

Preperation

Rice

Prepare the rice for 4 portions as instructed in the package and put it aside. You can add 1 tea spoon of chicken concentrate but remember to reduce any salt accordingly. Usually rice to water ratio is 1:2.

Chicken

Put the chicken in a bowl and add 1 tea spoon of salt, 1 tea spoon of corn flour, 1 tea spoon of sweet soy sauce, 1/2 tea spoon of banking soda and the thinly sliced chilli.
Mix thoroughly.
Put it in the fridge for around 20 minutes.
Once the chicken is ready. Put 1 table spoon of oil into a hot wok.
Then add half the garlic and ginger to that wok and let it fry for few seconds.
Then add the chicken. Leave the chicken flat on the wok for 2 minutes.
Then turn the chicken other way around. We want to make the chicken little brown but not burn it.
Put the cooked chicken into a clean bowl.

Eggs

Beat the 4 eggs lightly with 1 tea spoon of salt and 2 tea spoons of pepper.
Add 1 table spoon of oil to the hot wok and then add the eggs and scramble them until the eggs are little brown outside.
Put the cooked eggs into a clean bowl.

Stir fry

Add 2 table spoons of oil to the hot wok.
Add the garlic and ginger. Let it fry for few seconds.
Then add carrots and salty soy sauce and mix well.
Cover and let it cook for a minute.
Then add the leeks and cover mix well.
Cover and cook for 30s.
Then add the rice and mix well with the vegetables.
Then add chicken and scrambled eggs and mix well.
Let it sit on the stove for 30s but make sure nothing burns.
Enjoy!

Notes

I like food with less salt. You can add salt wherever mentioned as you prefer.
For the stir fry you can add bean sprouts, broccoli, bamboo shoots if you have them.
Serve with sweet chilli sauce or hot chilli sauce if you can’t find Chinese chilli paste.

HD Satellite TV finally in Sri Lanka

Fri, 22 Jun 2012 16:11:26 +0000

Dialog TV finally launched HD TV in their Satellite TV subscribers. I have been asking Dialog for HD TV for more than a year, so it was only fair I signed up gave it a shot.

Signing up was a breeze, no calls to the customer service hotline; a simple SMS to 679 and I was signed up. Then I had to wait for the decoder to be delivered, but that took less than 24 hours (18 hours may be) and it came with a technician :D. Big thumbs up to Dialog for quick response.

Channels

I know the HD subscription is too high for too few channels, but considering the fact that in a tiny island everything new is supposed to be expensive I’m not complaining. However more channels would be nice. I would personally like to see the following channels being offered in HD.

Discovery Channel
Discovery Science
HBO Bouquet
KidsCo
The Buddhist TV (This is a long shot, but one can ask)
Ten Action
Warner TV
VH1

Decoder

I got a OHS1720IR decoder which comes with HDMI, RCA and S/PDIF ports (I’m not counting the USB port used by the flash drive used for PVR). I’m glad Dialog finally has a decoder which support HDMI Video and Audio. Did I tell you it also supports Dolby Digital Audio.

PVR function is very handy, now my mom doesn’t have to complain about missing programs on The Buddhist TV :) When you sign up for HD Pack you get PVR for free. However the catch is you can’t record a SD channel and watch a HD channel or record a HD channel and watch any other channel. But that’s better than what we had before, so I’m not complaining.

However while preparing for the blog post I found a bug in the decoder firmware. If I take a screen capture of a HD channel remote stops working until you have to restart the DVR. But this is a borderline use case, so not a show stopper. My guess a memory leak in screen capture. It would be nice if Dialog could release a fix soon.

Also did I tell you the decoder support 1080p even though Dialog TV content is only 1080i. So the menus look better than the content itself. I hope we will soon see 1080p content ;)

Picture Quality

I guess I kept you waiting long enough before I showed you how good HD TV on Dialog TV looks. Both HD channels and SD channels look so much better on this decoder. I couldn’t find any flaws with the picture quality. All these were captured with the built in screen capture. Sizes will differ based on what what the source quality was. Please click through and checkout the quality in all it’s glory.

I might decide to upload a video shot with the stunning HD camera on my Samsung Galaxy Nexus to show you how good the video looks with the new decoder and show off the new HD Channels. So remember to subscribe to my RSS feed and check back in a few days :)

WYSIWYG editor in your WordPress theme or plugin

Wed, 14 Dec 2011 14:18:18 +0000

Prior to WordPress 3.3 adding WYSIWYG editor to a frontend page meant you had almost reinvent the wheel. In WordPress 3.3 wp_editor was introduced which made developer/designer’s life whole lot easier. Now you can add the same editor used when you type up a post can be added anywhere in your theme or plugin (frontend or backend).

I stumbled across this function by accident when I was checking why the WYSIWYG editor was not working on one of my plugins on WordPress 3.3 . You also can allow users to upload images if the user has necessary capabilities using the editor wp_editor adds.

Read all about it on the WordPress Codex . Hope someone will find it useful.

WordPress How To: Monthly,Yearly and Daily Archives for Custom Post Types

Tue, 25 Oct 2011 18:05:34 +0000

For a plugin I was creating I needed Yearly and Monthly archives with my own slug. Even after setting the rewrite rules it was not working. After much debugging and several hours later I finally figured it out. I’ll explain how you could do the same bellow.

Spoiler Alert: For the impatient, it was as simple as removing the old rules that are not setting the post type before adding the new rules :)

I’m going to assume that you have already familiar with Custom Post types. If you are not read http://codex.wordpress.org/Post_Types and then come back. Most important are Step 5 and Step 6. Other steps are typical for any plugin or theme using custom post types.

Step 1: Register the post type Read more about registering custom post types at register_post_type( ‘my_class’, array( ‘public’ => true, … ‘has_archive’ => true, ) ); Step 2: Add rewrite tags and permalink structure $event_structure = ‘/events/%year%/%monthnum%/%my_class%’; $wp_rewrite->add_rewrite_tag(“%my_class%”, ‘(.+?)’, “my_class=”); $wp_rewrite->add_permastruct(‘my_class’, $event_structure, false); Step 3: Add post_type_link and rewrite_rules_array filters add_filter(‘rewrite_rules_array’, ‘my_class_add_rewrite_rules’); add_filter(‘post_type_link’, ‘my_class_post_type_link’, 10, 3); Step 4: Return a proper permalink function my_class_post_type_link($permalink, $post_id, $leavename) { $post = get_post($post_id);

$rewritecode = array( ‘%my_class%’, ‘%year%’, ‘%monthnum%’ );

if ($post->post_type == ‘my_class’ && ‘’ != $permalink) {

$ptype = get_post_type_object($post->post_type);

$start = time(); $end = time();

$meta = get_post_custom($post->ID); // This is where I store when the class starts if (isset($meta[“my_class_start”]) && isset($meta[“my_class_start”])) { $start = strtotime($meta[“my_class_start”]); }

$year = date(‘Y’, $start); $month = date(‘m’, $end);

$rewritereplace = array( ($post->post_name == “”)?$post->id:$post->post_name, $year, $month, ); $permalink = str_replace($rewritecode, $rewritereplace, $permalink); } else { // if they’re not using the fancy permalink option }

return $permalink; } Step 5: Add rewrite rules function my_class_add_rewrite_rules($rules){ $new_rules = array();

// This is the important bit, unsetting the rules unset($rules[‘classes/({4})/({1,2})/?$’]); unset($rules[‘classes/({4})/?$’]);

$new_rules[‘classes/({4})/?$’] = ‘index.php?year=$matches&post_type=incsub_event’; $new_rules[‘classes/({4})/({1,2})/?$’] = ‘index.php?year=$matches&monthnum=$matches&post_type=incsub_event’; $new_rules[‘classes/({4})/({2})/(.+?)/?$’] = ‘index.php?year=$matches&monthnum=$matches&incsub_event=$matches’;

return array_merge($new_rules, $rules); } Step 6: Don’t forget to flush add_action(‘option_rewrite_rules’, ‘my_class_check_rewrite_rules’); function my_class_check_rewrite_rules($value) { global $wp_rewrite;

//prevent an infinite loop if ( ! post_type_exists( ‘incsub_event’ ) ) return;

if (!is_array($value)) $value = array();

$array_key = ‘events/({4})/?$’; if ( !array_key_exists($array_key, $value) ) { $wp_rewrite->flush_rules(); } $array_key = ‘events/({4})/({1,2})/?$’; if ( !array_key_exists($array_key, $value) ) { $wp_rewrite->flush_rules(); } $array_key = ‘events/({4})/({1,2})/(.+?)/?$’; if ( !array_key_exists($array_key, $value) ) { $wp_rewrite->flush_rules(); } } That’s it. Most important steps are Step 5 and Step 6

Days of the Week

Sat, 09 Apr 2011 19:39:34 +0000

I know it’s little late, but I got tired of all the hate towards Rebecca Black because her single is about Friday. I took the liberty to come up with a list of music videos of every single day of the week. Have fun watching and listening to them. All the other artist deserve the hate Rebecca Black got :D

Dialog Axiata APN update for Android mobiles

Tue, 23 Nov 2010 19:51:13 +0000

I was annoyed that I had to configure the APN every time I either installed a OS upgrade after a wipe or switched SIMs on my HTC Hero. I went and composed a complete list of APNs for Dialog Axiata. You just need to copy it to your Android based phone and boot into recover mode and flash the zip file. I hope to post in more detail soon, that’s it for now.

dialog-apns-0.1-signed

Blogging from the iPad

Mon, 13 Sep 2010 19:25:58 +0000

WordPress for iOS is not very handy to blog, specially if it has lot of text but it’s perfect on iPad. This post is made from the iPad and I’m loving it. May be I should start a separate blog for it :-?

Bottom line is WordPress for iOS is a win on the iPad. Since blogging became so much easier, expect more blog posts :D

Password reuse

Mon, 13 Sep 2010 05:51:03 +0000

Moha

Taming the Unpredictable: How an AGENTS.md File Keeps Your AI Team in Check

Dictating the Machine

Generating the Rules with agy

What Actually Goes Into AGENTS.md?

The Result: A Calibrated SDLC

The Ultimate Zero-Friction Blogging Experience: Pouta and Jekyll's Perfect Pairing

⚡ Unbelievable Speed

✍️ Zero-Friction Blogging

🛠️ The Ultimate Developer High

Sri Lankan style Chinese fried rice recipe

Ingredients

Chicken

Rice

Eggs

Stir fry

Preperation

Rice

Chicken

Eggs

Stir fry

Notes

HD Satellite TV finally in Sri Lanka

Channels

Decoder

Picture Quality

WYSIWYG editor in your WordPress theme or plugin

WordPress How To: Monthly,Yearly and Daily Archives for Custom Post Types

Days of the Week

Dialog Axiata APN update for Android mobiles

Blogging from the iPad

Password reuse

Generating the Rules with `agy`

What Actually Goes Into `AGENTS.md`?