{"id":41115,"library":"fnin-framework","title":"FNIN Framework","description":"FNIN (Framework New Idea Node) is a Node.js-based framework for orchestrating AI agent teams specialized in software engineering phases: requirements, architecture, development, testing, and deployment. Current version 1.0.7. It detects project context (new vs legacy) and generates artifacts incrementally. Unique differentiator is automatic context detection based on existing project files (package.json, .git) and continuous pipeline where outputs feed the next agent. Still uses stub agent implementations requiring manual LLM integration.","status":"active","version":"1.0.7","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","agents","software-engineering","ai","framework","fnin"],"install":[{"cmd":"npm install fnin-framework","lang":"bash","label":"npm"},{"cmd":"yarn add fnin-framework","lang":"bash","label":"yarn"},{"cmd":"pnpm add fnin-framework","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Package is meant to be used via npx; run command is the primary interface","wrong":"npm run fnin","symbol":"FNIN CLI","correct":"npx fnin run \"task description\""},{"note":"bin field required for npx invocation; main is for require(), not CLI","wrong":"{\"main\": \"./bin/cli.js\"}","symbol":"package.json bin","correct":"{\"bin\": {\"fnin\": \"./bin/cli.js\"}}"},{"note":"Agents are configured via file system, not code imports; customize by editing .md files","wrong":"import Alice from 'fnin-framework/agents'","symbol":"agents (Alice, Bob, etc.)","correct":"agent prompts are markdown files in agents/ directory"}],"quickstart":{"code":"// Step 1: Install and link (for local dev)\nnpm install\nnpm link\nchmod +x bin/cli.js\n\n// Step 2: Run with a task\nfnin run \"Create a user authentication endpoint\"\n\n// Step 3: Run with existing requirements file\nfnin run \"Analyze business rules from this document\" -f \"my-requirements.md\"\n\n// Step 4: Iterative execution (appends to artifacts)\nfnin run \"Add password reset email functionality\"\n\n// Outputs are written to .fnin_output/ directory","lang":"javascript","description":"Shows installation, basic task execution, file import, iterative refinement, and output location."},"warnings":[{"fix":"Edit src/agent.js to call OpenAI/Anthropic/Gemini API with this.systemPrompt and input.","message":"Default agents are stubs: they output placeholder text. You must implement real LLM calls in src/agent.js or the pipeline will generate no useful artifacts.","severity":"gotcha","affected_versions":"1.0.x"},{"fix":"Use \"fnin-framework\" as the package name (current). The readme snippet mentions \"fnin-frame\" which is incorrect.","message":"The package.json references \"fnin-frame\" in readme but actual intended name is \"fnin-framework\". Verify correct package name before publishing.","severity":"deprecated","affected_versions":"1.0.7"},{"fix":"Run fnin from inside a dedicated project folder; add .fnin_output to .gitignore.","message":"Output directory .fnin_output is created in the current working directory. Running in a project root may conflict with version control or deployment. Always ensure CWD is intended.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'1.0.7':31 'agent':16,64,68,75 'ai':15,79 'architectur':24 'artifact':41 'automat':46 'base':11,49 'context':35,47 'continu':57 'current':29 'deploy':28 'detect':33,48 'develop':25 'differenti':44 'engin':21,78 'exist':51 'feed':61 'file':53 'fnin':1,3,81 'framework':2,4,12,80 'generat':40 'git':55 'idea':6 'implement':69 'increment':42 'integr':73 'javascript':74 'legaci':38 'llm':72 'manual':71 'new':5,36 'next':63 'node':7 'node.js':10 'orchestr':14 'output':60 'package.json':54 'phase':22 'pipelin':58 'project':34,52 'requir':23,70 'softwar':20,77 'software-engin':76 'special':18 'still':65 'stub':67 'team':17 'test':26 'uniqu':43 'use':66 'version':30 'vs':37","created_at":"2026-06-04T18:50:50.649824+00:00","updated_at":"2026-06-04T18:50:50.649824+00:00","problems":[{"fix":"Run fnin from the project root where package.json is located, or publish correctly with npm link.","cause":"Running from a different directory than package root or missing file in bin/cli.js path","error":"Error: Cannot find module '../src/agent'"},{"fix":"Run 'npm link' in the package directory, or use 'npx fnin-framework run' directly.","cause":"Package not installed or bin not linked globally","error":"fnin: command not found"},{"fix":"Ensure agents/ directory contains .md files for each agent (Alice.md, Bob.md, etc.) with valid prompts.","cause":"Agent instance used without proper initialization or missing system prompt file in agents/","error":"TypeError: Cannot read properties of undefined (reading 'systemPrompt')"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"fnin-framework","openapi_spec":null,"status_page":null,"smithery":null,"categories":["ai-ml","devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-04","next_check":"2026-09-02","install_tag":null}}