Skip to content

Instantly share code, notes, and snippets.

@peterroelants
peterroelants / code-quality-in-agentic-software-engineering.md
Last active August 22, 2026 12:21
Code quality in agentic software engineering — version 1.26: an evidence-led report on maintainability, measurement, verification, tools, and continuous improvement (evidence through 22 August 2026)

Code Quality in Agentic Software Engineering

Why it matters, why it resists measurement, and how to govern automated development

Version 1.26 · Updated 22 August 2026 · Evidence cut-off 22 August 2026 · Links checked 22 August 2026

Written and researched by OpenAI Codex, under the direction and editorial guidance of Peter Roelants

License: Creative Commons Attribution 4.0 International

@peterroelants
peterroelants / dark-software-factories.md
Last active August 23, 2026 19:39
Dark software factories: an evidence-led report on their abstraction layer, operation, guardrails, evidence, and limits (version 3.7; 23 August 2026)

Dark Software Factories

What they are, how they work, and what it takes to run one

Version 3.7 · 23 August 2026

Written and researched by agents such as Codex, under the direction and editorial guidance of Peter Roelants

Working definition. A dark software factory is a development system in which people specify intent, constraints, and acceptable behavior while software agents produce and validate the implementation. In the strict form, people neither write nor routinely review the generated code; they operate the factory that does.

@peterroelants
peterroelants / conv_vs_patch.ipynb
Created September 18, 2025 07:58
Illustration of the difference between a 2x2 conv and a patchify + 1x1 conv
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
@peterroelants
peterroelants / simple_filesystem.py
Created January 20, 2025 09:13
Fsspec toy filesystem
from __future__ import annotations
import io
from typing import Literal, TypedDict, TypeVar, Union
from fsspec.spec import AbstractFileSystem
# Create a recursive type for the store dictionary
T = TypeVar("T")
StoreDict = dict[str, Union[bytes, "StoreDict"]]
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
@peterroelants
peterroelants / compose.py
Created January 26, 2024 19:20
Python Function composition
from functools import partial
from typing import Protocol
class Callable(Protocol):
def __call__(self, *args, **kwargs):
...
class Params:
@peterroelants
peterroelants / fastapi_static_nocache.py
Created October 11, 2023 18:34
FastAPI Cache-Control : no-cache
from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles
class StaticNoCache(StaticFiles):
"""Disable caching of static files serverd"""
def is_not_modified(self, *args, **kwargs) -> bool:
return False
def file_response(self, *args, **kwargs):
@peterroelants
peterroelants / wiki_search_trace_tree.html
Created September 24, 2023 11:05
Wikipedia search agent tracing visualisation.
This file has been truncated, but you can view the full file.
<html>
<head>
<style>.tree {
position: relative;
}
/* Define variables used in tree-node */
:root {
--indent: 1em;
@peterroelants
peterroelants / main.py
Created September 22, 2023 19:08
FastAPI example web app for OAuth2 Authorization Code Flow
"""
FastAPI example web app for OAuth2 Authorization Code Flow.
Run with:
```
uvicorn main:app --reload --log-config=log_conf.yaml
```
"""
import logging
@peterroelants
peterroelants / openai_function_calling_react_loop.py
Last active October 4, 2023 07:38
Simple example of OpenAI Function Calling in ReAct Loop
"""
Simple example of OpenAI Function Calling in ReAct Loop.
Functions are described in JSON with each parameter the function accepts described as a JSON Schema object.
More info:
- OpenAI Function Calling
- https://openai.com/blog/function-calling-and-other-api-updates
- https://platform.openai.com/docs/guides/gpt/function-calling
- https://platform.openai.com/docs/api-reference/chat/create#chat/create-functions