Building Atlassian Forge app with Kiro

Pak Wai — Sun, 30 Nov 2025 16:18:20 +0000

I am so glad that I have took some time out of my day to tryout this Kiroween hackathon. A little bit of background, I have been building apps on Atlassian ecosystem for quite a number of years already. Therefore, the advantage I had in this is my domain knowledge to build on this ecosystem.

Demo

Without further a due, here is the project that I have been working on.

Guess what, all these that you're seeing, it took me not more that 2 days of my weekend to vibe this out. It was also a surprise for me seeing how easy to build this on Kiro with spec driven approach if we have all the basic agent instructions and prompts setup.

Setup

Agents.md

To start Atlassian's forge project, you're need to install the @forge/cli. Feel free to get started here.

The key thing here is, when you bootstrap the project with forge create, you'll noticed that it comes with an AGENTS.md. Kiro treated this as the steering docs, which helped the agent so much when I am vibing and building the specs on Kiro.

Forge MCP

The other things that wasn’t created by default, but I have added it is the Atlassian Forge MCP server. By just adding this to the mcp.json, we’re literally good to go.

{
  "mcpServers": {
    "forge-knowledge": {
      "url": "https://mcp.atlassian.com/v1/forge/mcp",
      "transport": "http"
    }
  }
}

Just like the Agents.md, everything works so seamlessly well together. The context of MCP helps the agent to stay in context when building the apps is what amaze me the most.

Assisted coding

The original Agents.md has enforced with UI Kit for the frontend. However, knowing that I need to use custom React Flow library to achieve the amazing drag and drop flow, I need to use custom UI. And, with the small tweak to the Agents.md everything works nicely for me.

Conclusion

Kiro is such a fun tools to work with, and while this is the second time I am using it, the output seems to be much better when it initially launched.

With the integration of Agents, Steering Docs, Specs, and MCP. We’re able to be so much more effective to prevent hallucination and enjoy the process of working with AI to pair programming or vibe code.