chore(docs): Update READMEs

README.md

@@ -2,8 +2,6 @@
 
 `agent-kilt` provides a convenient way to add additional software to containers by patching ECS TaskDefinitions.
 
-
-
 Kilt is a definition on how to include additional software inside containers. It was created to run falco in userspace
 along other software. It leverages different runtimes to perform modifications to the container
 
@@ -29,6 +27,7 @@ is not running yet. Run time is well, you get it.
     * **build.mount.image** `str` - the image that contains the volume of the mount
     * **build.mount.volumes** `List(str)` - List of paths to be mounted on the target image
     * **build.mount.entry_point** `List(str)` - The entry point of the image (needed for patching runtimes)
+
 ### Example
 ```
 build {
@@ -49,13 +48,11 @@ build {
 }
 ```
 
-
-
 # Release
 
 To make a new release push a new tag. 
 
-It will trigger the [release-runtime.yml](.github/workflows/release-runtimes.yml) workflow.
+It will trigger the [release](.github/workflows/release.yml) workflow.
 
 For tags, use [semver](https://semver.org/).
 

runtimes/cloudformation/README.md

@@ -4,11 +4,17 @@ It installs a Cloud Formation Macro that will alter the incoming template.
 
 ## Components
 
-* `installer` - installer for the macro
+### Commands
+
 * `cmd/handler` - the golang lambda functions powering the Macro
-* `cmd/cfn-apply-kilt` - applies kilt transformation to a CFN template
-* `cmd/cfn-image-info` - gets configuration for the image from repository
+* `cmd/cfn-apply-kilt` - test application that applies kilt transformation to a CFN template
+* `cmd/cfn-image-info` - test application that gets configuration for an image from repository
+
+The `handler` is the main deliverable and the other applications exist to test and demo the functionality.
+
+### Patcher
 
+The `cfnpatcher` is a general library to apply migrations to a template.
 
 # Usage
 The installer will create a CFN macro that you can use to apply automatically
@@ -24,4 +30,4 @@ task definition:
 * `"kilt-include-containers": "containerA:ContainerB"` - value is a colon separated list of 
   container names. Will include only some contaiers in opt-in mode
 * `"kilt-ignore-containers": "containerA:containerB"` - will exclude some containers in 
-  opt-out mode
+  opt-out mode

runtimes/cloudformation/cmd/handler/README.md

@@ -0,0 +1,28 @@
+# Handler
+
+The `handler` is designed to be deployed as an AWS lambda to apply transformations to a task definition.
+
+## Build
+
+The `handler` uses `goreleaser` for builds and releases. The defintion can be found in `runtimes/cloudformation/.goreleaser.yml`.
+
+*Note* to build the FIPS variant, you need to have [zig](https://github.com/ziglang/zig/wiki/Install-Zig-from-a-Package-Manager) installed.
+
+```bash
+$ cd runtimes/cloudformation
+$ GORELEASER_CURRENT_TAG=0.0.1 goreleaser build --skip=validate --clean
+...
+$ ls -R dist/
+dist/:
+artifacts.json  config.yaml  handler  metadata.json
+
+dist/handler:
+handler-fips-linux-amd64  handler-fips-linux-arm64  handler-linux-amd64  handler-linux-arm64
+```
+
+## Test
+
+```bash
+$ cd runtimes/cloudformation
+$ go test -race -mod=readonly ./...
+```